Setting Your Default Agent

Configure which coding agent Blocks uses by default for your requests

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:

Configure Claude Code

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

Configure Codex

1. Get an OpenAI API key
2. Go to Dashboard → Agents → Codex
3. Enter your API key or subscription

Learn more about Codex

Configure Gemini CLI

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

Can I have different defaults for GitHub vs Slack?

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.

What happens if my default agent's API key or subscription expires?

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

Do I need to configure all three agents?

No, you only need to configure at least one agent. However, configuring multiple agents gives you more flexibility and options.