CLI Reference
Lower-level commands for automation, scripting, and agent-driven workflows.
Most people live in the TUI. These commands exist so scripts and agents can manage tasks, repos, and workspaces without touching the interface.
Launch
craig | Open the TUI |
Repos
craig repo add <path> | Register a repo with Craig |
craig repo list | List registered repos |
craig repo remove <repo-id> | Unregister a repo |
Workspaces
craig workspace add <path> | Register a repo or parent-directory workspace |
craig workspace list | List workspaces |
craig workspace list --archived | Include archived workspaces |
craig workspace archive <id> | Archive a workspace |
craig workspace restore <id> | Restore an archived workspace |
craig workspace remove <id> | Delete a workspace |
Tasks
craig task new --repo <id> "<prompt>" | Create a task (optionally with --runner) |
craig task new --workspace <id> "<prompt>" | Create a project workspace task |
craig task list | List all tasks |
craig task list --repo <id> | List tasks for a specific repo |
craig task show <id> | Show task details |
craig task attach <id> | Attach to task PTY |
craig task focus <id> | Focus the task tmux pane |
craig task open <id> | Open or print the task worktree path |
craig task logs <id> | Stream task logs |
craig task diff <id> | Show task diff |
craig task check <id> | Run configured check commands |
craig task commit <id> | Commit task changes |
Links
craig link add <task-id> <repo-id> | Link a task to an additional repo |
craig link list <task-id> | List linked repos for a task |