Commands Every clu subcommand at a glance, grouped the way clu --help groups them.
clu is a single binary with kong-driven subcommands. Every command supports
--json for one-shot machine output and --quiet to suppress narrative.
Every --json invocation emits exactly one JSON value on stdout.
For the authoritative, always-current list:
clu --help clu < comman d > --help command what it does clu initCreate .clu/ with data.sqlite + a default config.yaml. clu create <title>Create an issue. Flags: -p priority, -a assignee, -d depends-on, --capability, --description, --notes, --type. clu list (ls)List issues. Filter by -a <agent>, status, -l <label>, priority. clu readyIssues whose deps are satisfied and that aren't claimed. -a scopes to a lane; --watch streams changes. clu blockedIssues with at least one open dependency. clu show <id>Print one issue's full record. --context prints the upstream dependency chain too. clu claim [id]Atomically take the next ready issue (or a specific one). --wait blocks; --heartbeat advertises liveness; --context inherits upstream notes. clu close <id…>Mark issue(s) closed. Unblocks dependents. clu reopen <id…>Reverse closed or cancelled back to open. clu cancel <id>Mark issue and all transitive dependents as cancelled. clu update <id>Update fields (status, priority, assignee, description, …).
Thin wrappers that delegate to update / store methods — each is 10–20 lines.
command what it does clu assign <id> <agent>Set assignee. clu priority <id> <n>Set priority (0 highest … 4 lowest). clu describe <id> <text>Set or clear the description. clu note <id> …Manage freeform notes. clu comment <id> …Manage comments (add -a <agent> <text>, ls). clu label <id> … / clu tag <id> <label…>Manage / add labels. clu dep … / clu link <a> <b>Manage / add a dependency edge. clu defer <id> / clu undefer <id>Defer an issue until later / clear the deferral.
command what it does clu agent ls (list)List declared agents with a live/heartbeat indicator. clu agent start <name>Launch a declared agent (its config.yaml command + layered prompts), heartbeating while it runs. clu agent show <name>Show one agent's full record. clu briefPrint AGENTS.md + declared agents + who's live + persisted memories. Pipe into a session at start. clu lock <name> -- <cmd>Acquire a TTL'd named lock around <cmd>. clu unlock <name> / clu locksRelease a lock / list current locks. clu ping <agent> <msg>Drop a fire-and-forget message in an agent's mailbox. clu inboxRead pings addressed to you (--peek to leave unread). clu worktree …Manage git worktrees with project-defined bootstrap.
command what it does clu run <template>Instantiate a workflow template. Pass vars with -v key=value. clu template …Inspect and validate templates in .clu/templates/. clu checkpoint pass|fail -a <agent> <id>Clear or cascade-cancel a checkpoint gate. clu approve -a <agent> <id>Sugar for checkpoint pass.
command what it does clu history <id>Audit trail for one issue, oldest first. clu logGlobal event stream, newest first. Filter by --actor / --kind / --issue / --since. clu countCount issues matching the same filters as list. clu statsIssue counts grouped by status, agent, and type. clu infoDatabase path, schema version, and an issue summary. clu doctorIntegrity + health checks against the database. clu statuses / clu typesList valid statuses / issue types.
command what it does clu batchInstantiate a whole issue graph from one JSON doc, atomically. See Importing & bulk graphs . clu exportDump issues + deps + labels + comments + KV + cron as JSONL (-o file). clu importRestore JSONL produced by clu export (--lenient skips bad lines). clu syncSync issue state to a branch-independent git ref. push / pull / status / flush; --remote to go cross-machine. Experimental — see Sync . clu kv …A generic key-value store (flags, env, scratch data). clu sql <query>Ad-hoc SQL (read-only by default; --write for DML/DDL). clu cron …Schedule recurring clu invocations (drive from OS cron / launchd). clu httpStart just the REST API over the store. clu webLaunch the web UI (REST API in-process + frontend) on :5757.
command what it does clu versionPrint version information. clu completion <shell>Generate a shell completion script.