CLI commands

ninja [flags]                 # interactive TUI in current directory
ninja <command> [args]

Core

Command	Description
`ninja`	Start interactive session
`ninja doctor`	Check config, model endpoint, MCP, session dir
`ninja --version`	Print version
`ninja --help`	All flags and commands

Sessions

ninja session list              # list saved sessions
ninja session list -v           # verbose
ninja session load <id>         # resume
ninja session delete <id>       # delete
ninja session rewind <turn>     # restore files + truncate history to pre-turn
ninja session rewind <turn> --session <id>

Policy

ninja policy check "rm -rf build"

Exit codes: 0 auto-allow · 2 would confirm · 3 hard deny.

Worktrees

ninja worktree list
ninja worktree active
ninja worktree create <path> [branch]
ninja worktree remove <path>

Use worktrees to run agents on isolated branches.

Headless

ninja -p "summarize the README" --mode text
ninja -p "add a health endpoint" --mode json --yes

See Flags.

TUI slash / keys (interactive)

Input	Action
`/exit` or `/quit`	Quit Ninja (clean exit; same as Ctrl+D)
`/model`	Model picker
`Enter`	Send
`Alt+Enter`	Newline
`Tab`	Cycle agent tabs
`Shift+Tab`	Toggle session auto-approve
`Esc` / `Ctrl+G`	Stop generation
`Ctrl+A`	Attach files
`Ctrl+X`	Clear attachments
`Ctrl+D` / `Ctrl+C`	Quit Ninja
`y` `n` `s` `p` `g`	Approval keys (input must be empty)