Install

Get Craig running in under a minute.

Requirements

  • Node.js 22 or newer
  • git
  • At least one installed and authenticated agent CLI: Claude Code, Codex, or Cursor
  • gh, authenticated with GitHub, for pull request discovery and review status

Install Craig

npm install -g craig-cli

Start Craig

Run Craig from the workspace root where you want its local .craig/ state to live:

cd path/to/your/workspace
craig

The TUI opens with a boot overlay, then a full-screen workspace with task navigation, a center work area, and an inspector panel. Head to Quickstart to run your first task.

Craig can run tasks without GitHub integration, but the Review panel needs gh to discover pull requests and synchronize checks, reviews, and comments.

Local state

Craig keeps task records, worktrees, runtime data, logs, and configuration under the workspace's .craig/ directory. Do not commit it; ignore .craig/ when the workspace root is a Git repository. Craig has no hosted account or control plane, although each agent CLI continues to use its own authentication and network services.