Skip to main content

​
What is a Default Agent?

When you make a request to Blocks, you can either:
  1. Use the default agent (implicit): 
    @blocks review this code for issues
  2. Specify a particular agent (explicit): 
    @blocks /claude review this code for issues
@blocks /codex implement this feature
@blocks /gemini analyze the architecture
Your default agent is the one used when you don’t explicitly specify which agent to use with a slash command.

​
Setting Your Default Agent

1

Open Blocks Dashboard

Navigate to Blocks Dashboard and sign in
2

Go to Agents

Navigate to Dashboard → Agents
3

Select Default Agent

  1. Find the agent you want to set as default from your configured agents
  2. Click on the dropdown menu for that agent
  3. Select “Set as default agent”

​
Prerequisites: Configure Agents First

Before you can set a default agent, you must configure at least one agent with an API key:
  1. Get an Anthropic API key
  2. Go to Dashboard → Agents → Claude Code
  3. Enter your API key or subscription
Learn more about Claude Code
  1. Get an OpenAI API key
  2. Go to Dashboard → Agents → Codex
  3. Enter your API key or subscription
Learn more about Codex
  1. Get a Google AI API key
  2. Go to Dashboard → Agents → Gemini CLI
  3. Enter your API key
  4. Click “Save”
Learn more about Gemini CLI

​
Best Practices

​
Configure Multiple Agents

Even if you have a default, configure multiple agents:
  • Gives you flexibility for different tasks
  • Lets you fall back if one agent has issues
  • Allows experimentation with different approaches

​
Review and Adjust

Periodically review your default agent choice:
  • Has your workflow changed?
  • Are you frequently overriding the default?
  • Would a different agent serve you better?

​
Team Consistency

For team workspaces, consider:
  • Discussing a team default
  • Documenting when to use which agent
  • Sharing best practices for agent selection

​
Use Slash Commands Liberally

Don’t hesitate to override your default:
  • Use the best agent for each specific task
  • The default is for convenience, not a constraint
  • Experiment with different agents

​
Common Questions

No, the default agent is set per workspace, not per platform. However, you can always use slash commands to specify which agent to use on any platform.
Blocks will return an error. You’ll need to either:
  • Update the API key or subscription for that agent
  • Change your default to a different configured agent
  • Use slash commands to specify a working agent
No, you only need to configure at least one agent. However, configuring multiple agents gives you more flexibility and options.