Tutorial 4: Pick Your Agent

Each project remembers its agent. The dashboard, daemon, and session dispatch all follow that choice.

ccmux — pick agent

At project-creation time

When you press n on the Projects screen, the form has an Agent row. Use ← / → to cycle through:

• Claude (claude) — Anthropic’s Claude Code
• Codex (codex) — OpenAI’s Codex CLI
• Antigravity (agy) — Google’s Gemini CLI
• Cursor (cursor-agent) — Cursor’s CLI agent
• Pi (pi) — Earendil Works’ pi
• Grok (grok) — xAI’s Grok Build CLI

Press Enter to create the project with that agent.

CLI equivalent.

ccmux new my-service   # creates with the default agent (Claude)

The agent is stored at <project>/.ccmux/agent — edit that file directly to change it.

Change an existing project’s agent

The agent sidecar is a single-line text file:

echo "codex" > ~/Projects/my-service/.ccmux/agent

Valid values: claude, codex, agy, cursor, pi, grok

The next session you start from ccmux for that project uses the updated agent.

Set a machine-wide default

To change which agent the new-project form pre-selects on this machine:

# ~/.config/ccmux/config.toml
[agents]
default = "codex"

Edit inline from the TUI: press 6 (Settings), navigate to the default agent row, and press Enter to cycle through options.

Agents screen

Press 5 in the TUI to open the Agents screen, with a sub-tab per agent (Claude, Codex, Antigravity, Cursor, pi, Grok). Claude, Codex, and Antigravity expose editable config — model selection, global instructions (~/.claude/CLAUDE.md), and slash commands. Cursor, pi, and Grok manage their own config via their CLIs (and read the shared AGENTS.md).

Spotted an error or something out of date? Edit this page on GitHub.