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
@blocks /opencode use GPT-5 for this task
@blocks /sisyphus implement full-stack feature
@blocks /cursor refactor with parallel agents
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 an Anthropic API key or OpenAI API key
  2. Go to Dashboard → Agents → OpenCode
  3. Enter your API key for your chosen provider
Learn more about OpenCode
Experimental agents: Gemini CLI, Cursor CLI, and Sisyphus cannot be set as default agents. These agents must be invoked explicitly using slash commands (/gemini, /cursor, /sisyphus).

​
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. Note that some agents (Gemini CLI, Cursor CLI, Sisyphus) cannot be set as default.
No, these agents cannot be set as default. You must use slash commands (/gemini, /cursor, /sisyphus) to invoke them explicitly. OpenCode is experimental but can be set as default.