Skip to content

Agents

Every agent runs as an external ACP subprocess — Nori is the harness around it. Pick with /agent in the TUI or -a <slug> at launch.

Slug Provider Context window Runs via
claude-code (default) Anthropic 1M the Claude Code ACP adapter
codex OpenAI 258K the Codex ACP adapter
gemini Google 1M Gemini CLI’s native ACP mode

Adapters launch through bunx when bun is on your PATH, otherwise npx.

Register any ACP-speaking agent in ~/.nori/cli/config.toml:

[[agents]]
name = "My Agent"
slug = "my-agent"
[agents.distribution.npx]
package = "my-acp-agent"
args = ["--acp"]

Distribution variants: local (a command on your machine), npx, bunx, pipx, or uvx. Optional keys: context_window_size, auth_hint, transcript_base_dir. A custom slug that matches a built-in replaces it.

Capabilities are agent-driven: Nori enables /compact, /fork, session listing, and /config per agent based on what the agent advertises in its ACP handshake.

this page as markdown: /cli/guides/agents.md· index for agents: /llms.txt