agex
Docs menuSupported agents

Reference

Supported agents

The agent CLIs agex supports, what it can do with each one, and how to add your own.

Detected agent CLIs

agex supports 30 agent CLIs. It looks for them through your login shell's PATH and common install folders, and only the ones installed on your Mac show up in the New agent menu.

After installing a new agent, choose Rescan for agents in the New agent menu. To hide an agent you have installed, add its id to agents.hidden.

What works with each agent

AgentNew agentHistoryResumeContextSub-agentsThreadsQuestions
Claude Code✓✓✓✓✓✓✓
Codex✓✓✓✓✓✓
Gemini CLI✓✓✓
Antigravity✓
Cursor Agent✓✓
GitHub Copilot CLI✓✓✓✓
OpenCode✓✓✓✓✓✓
Crush✓✓✓✓
Amp✓✓
Aider✓≈
Goose✓✓
Cline✓✓
Kilo Code✓✓✓✓✓
Qwen Code✓✓
Kimi CLI✓✓
Kiro CLI✓✓✓✓
Droid✓✓
Auggie✓✓
OpenHands✓✓
Mistral Vibe✓✓
Qodo Command✓
Blackbox CLI✓
Jules✓
Trae Agent✓✓
Continue✓✓
Amazon Q✓≈
Pi✓✓✓✓
Grok CLI✓≈
Junie✓✓
Qoder CLI✓✓

Reading the table

  • New agent: the agent shows up in the New agent menu and in the command palette once it's installed.
  • History: its past sessions are listed in History. For Copilot CLI, that includes VS Code's Copilot agent.
  • Resume: agex can reopen its sessions. That covers Interrupted agents and threads, and, for agents with a History mark, History. Kilo Code and Pi sessions can be resumed from Interrupted and from their threads.
  • Context: the status bar's context meter tracks its context window. ✓ means the agent writes down its token counts. ≈ means the number is estimated: Grok CLI's and Amazon Q's records don't hold the context size, and Aider rounds its counts. A blank cell means the agent keeps nothing agex can read.
  • Sub-agents: its sub-agents at work are listed under it. For Claude Code, that's its Task and Agent tool. See Sub-agents.
  • Threads: conversations branched off its session are listed under it. For Claude Code, that's /branch, /fork and --fork-session. See Threads.
  • Questions: its numbered permission and choice prompts appear in the sidebar, so you can answer with a click. See Questions.

More agent-specific features

FeatureAgents
Prompt cache countdown in the status barClaude Code
Writing commit messages with the pen buttonClaude Code or Gemini CLI, or any command you set in git.commit_message_command
Reading state, task and last action when running elsewhereClaude Code. Codex gives its first prompt; for other agents, CPU use counts as working. See Agents running elsewhere.
Background sessionsClaude Code (claude --bg)
The agex-notes skill in its own skills folderClaude Code (~/.claude/skills) and Kiro (~/.kiro/skills). Most other CLIs read ~/.agents/skills. See Notes.

Custom agents

agents.custom adds agent CLIs agex doesn't know about, or overrides a built-in one when you use the same id. Each entry has an id, a name and a command:

{
  "agents": {
    "default": "codex",
    "custom": [{ "id": "codex", "name": "Codex", "command": "codex --full-auto" }],
    "hidden": ["goose"],
  },
}

This example makes Codex start with --full-auto, makes it the agent that ⇧⌘T and New agent start, and hides Goose.

A custom agent shows up once its executable is found, like any other.

Logos

Agent logos come from agentlogos.dev, except Crush's, which comes from its own repository. An agent without a logo shows its app's icon from your Mac, or its initial.