Add a driver

A driver tells a workspace which agent CLI to run. Omit it and Agentissimo defaults to Claude Code.

Set the driver

In the workspace’s agentissimo.yaml:

version: 1
agentDriver:
  kind: codex      # claude-code | codex | cursor | copilot | pi

Per-developer overrides live in the app data folder (<data_dir>/projects/<id>/local.yaml), same schema, local-wins per field. Use it to run a different driver than your teammates without touching the committed file:

# <data_dir>/projects/<id>/local.yaml
agentDriver:
  kind: claude-code

Install the CLI

Agentissimo drives the CLI already on your machine. Install the matching binary and put it on your PATH:

kind	Binary
claude-code	claude
codex	codex
cursor	cursor-agent
copilot	copilot
pi	pi

A missing CLI surfaces exactly:

spawn ENOENT codex

Install the named CLI, or change agentDriver.kind to one you have.

Cloud API providers (bring your own key)

OpenRouter and the cloud vendors — DeepSeek, Gemini, Qwen, MiniMax, Kimi, GLM, Grok, Mistral, Llama, MiMo — run through the Codex driver pointed at the vendor’s OpenAI-compatible gateway, so a wide model catalog is reachable without a dedicated binary. They are not set via agentDriver.kind; connect each with your own API key in Settings → AI Harnesses, then select it per chat from the model picker. Pair it with a model id — see Model selection & effort.

Limit tools

Restrict what an agent may invoke with allowedTools:

agentDriver:
  kind: claude-code
  allowedTools: [Read, Edit, Bash]