DocsSupported Agents

Supported Agents

Blueprint Stack ships with 2 built-in agents and supports unlimited custom agents. You can switch between agents per session or run multiple agents in parallel across tabs. Selecting a different agent from the picker opens a new tab automatically. CLI and ACP adapter installs are manual; Blueprint Stack does not auto-download dependencies. Select an agent below for setup instructions.

Agent Picker Behavior

  • -Selecting a different agent from the picker opens a new tab for that agent.
  • -Your current chat tab is preserved, so you can keep multiple concurrent sessions (for example, one Claude Code tab and one Codex tab).
  • -Each agent in the picker shows a status label: Available, Not Installed, or Missing API Key.

Built-in Agents

Claude Code

Recommended

Anthropic's coding agent. Communicates via JSON-RPC over stdio through the claude-code-acp adapter. Supports session resume, extended thinking, and streaming.

Models:Claude Sonnet 4, Claude Opus 4
# Quick setup
npm install -g @zed-industries/claude-code-acp

Codex (OpenAI)

OpenAI's Codex agent. Requires the codex-acp adapter for Blueprint Stack integration.

Models:GPT-4, o3, o4-mini
# Quick setup
npm install -g @openai/codex && npm install -g @zed-industries/codex-acp

Custom Agents

You can add unlimited custom ACP-compatible agents via Project Settings > Plugins > Blueprint Stack > Agents.

Custom agent configuration includes:

  • -Executable path - Path to the agent binary or command name.
  • -Arguments - Command-line arguments passed to the executable.
  • -Working directory - Directory the agent process runs in.
  • -Environment variables - Key-value pairs injected into the agent process.
  • -API key - Optional authentication credential.
  • -Model ID - Optional model identifier to pass to the agent.
  • -Install command - Shell command shown to the user for installing the agent.

Path Resolution

Blueprint Stack resolves agent executables by searching the following locations:

  • -System PATH
  • -npm global bin directory
  • -bun global bin directory
  • -cargo bin directory
  • -volta bin directory
  • -fnm bin directory
  • -asdf shims directory
  • -mise shims directory
  • -scoop shims directory
  • -Homebrew bin directory

Status Labels

The agent picker shows a live status for each agent:

  • -Available - The agent executable was found and is ready to use.
  • -Not Installed - The agent executable was not found in any resolved path.
  • -Missing API Key - The executable was found but authentication is not configured.