Agents
Claude Code, Codex CLI, Gemini CLI, OpenCode, Muse Code, your shell and custom commands.
An agent is anything CodeHerd can run in a pane. CodeHerd looks for each CLI on your login-shell PATH, the same one your terminal uses, and shows its version in Settings → Agents.
Each agent is a separate product, made by its own developer and used under its own terms. CodeHerd runs the copy you installed, unchanged; it never signs in for you or touches your credentials, so your plan and billing stay between you and the agent's maker.
Claude Code
Anthropic's agentic coding CLI. CodeHerd runs claude.
| Install with | Command |
|---|---|
| Native installer (recommended) | curl -fsSL https://claude.ai/install.sh | bash |
| Homebrew | brew install --cask claude-code |
Official guide: code.claude.com
Codex CLI
OpenAI's coding agent for the terminal. CodeHerd runs codex.
| Install with | Command |
|---|---|
| npm | npm install -g @openai/codex |
| Homebrew | brew install --cask codex |
Official guide: developers.openai.com
Gemini CLI
Google's open-source AI agent for the terminal. CodeHerd runs gemini.
| Install with | Command |
|---|---|
| npm | npm install -g @google/gemini-cli |
| Homebrew | brew install gemini-cli |
Official guide: geminicli.com
OpenCode
The open-source AI coding agent for the terminal. CodeHerd runs opencode.
| Install with | Command |
|---|---|
| Install script | curl -fsSL https://opencode.ai/v2/install | bash |
| Homebrew | brew install anomalyco/tap/opencode-v2 |
| npm | npm install -g @opencode/cli |
Official guide: opencode.ai
Muse Code
Meta's coding agent for the terminal. CodeHerd runs muse.
| Install with | Command |
|---|---|
| Native installer | curl -fsSL https://dev.meta.ai/install.sh | sh |
Official guide: dev.meta.ai
Shell
Your login shell (zsh by default) with your usual configuration. Always available, for anything that isn't an agent.
Custom commands
Add any command line in Settings → Agents → Custom commands, or straight from the Start a session picker: aider --model sonnet, goose session, npm run dev. Custom commands run through your login shell, so pipes, quotes and environment variables work.
After installing a CLI
~/.zshrc are picked up without restarting.