Runners

Choose which agent Craig launches in managed TUI sessions.

Craig supports Claude Code, Codex, and Cursor. Each one needs to be installed and on your PATH. When you create a task or add an agent tab, Craig drops the runner into that task's worktree and starts it in a managed PTY. The task prompt is stored as metadata — Craig doesn't paste it into the runner for you.

Selecting a runner

Pick your runner while creating a task or adding an agent tab in the TUI. From the command line:

craig task new --runner claude "your task prompt"

Enabling / disabling runners

Configure which runners are available in .craig/config.json:

{
  "runners": {
    "codex":  { "enabled": true },
    "cursor": { "enabled": true },
    "claude": { "enabled": false }
  }
}

Custom runner path

If the binary isn't on your PATH, point Craig at it in config. Takes effect on the next session you create.

{
  "runners": {
    "claude": {
      "enabled": true,
      "path": "/usr/local/bin/claude"
    }
  }
}