9. CLI & GraphQL Reference

9.1 Task & Ticket Lifecycle CLI

chinwag tasks init | list | split | verify

Complete command-line reference for bootstrapping <org>/chinwag-tasks, claiming disjoint file-scope leases, fanning out sub-tasks, and completing verified work.

9.1 Task & Ticket Lifecycle CLI

chinwag tasks init | list | split | verify

The chinwag tasks (repository-level queue management) and chinwag task (individual ticket lifecycle) subcommands manage atomic Markdown task specifications, disjoint --file-scope leases, .codegraph blast-radius checks, and Shadow jj workspace isolation.

`chinwag tasks` Subcommands

chinwag tasks <SUBCOMMAND> [OPTIONS]

Subcommand	Credit Cost	Description
`chinwag tasks init`	`0 Cr`	Bootstraps `<org>/chinwag-tasks.git` in the Chinwag Encrypted Artifact Store, builds `.chinwag/codegraph.bin`, and links GitHub Projects v2 or Linear (100% webhook-free).
`chinwag start <ISSUE-ID>`	`0 Cr`	Executable Tickets `0s` Cold-Start Hydration: Synchronously spawns zero-copy `repo.fork()` (`<org>/<project>--task-<ISSUE-ID>.git`), attaches `.codegraph` symbols & `.chinwag/regressions/*` Tombstone cassettes, and pre-warms `refs/chinwag/tasks/<ISSUE-ID>/shadow-kv`.
`chinwag teleport <ISSUE-ID> --at-step <N>`	`250 Cr`	1-Click Ticket Teleportation (`<300 ms`): Hands off an in-flight ticket (`Builder` → human or `Reflex-1`) with exact `project_worktree_oid`, warm Shadow-KV, and a 10-minute `art_v1_` token (same or cross-model).
`chinwag tasks list`	`0 Cr`	Lists active, ready, blocked, and verification-pending tasks with their `<SEAT>#<INSTANCE>` lease holders in `<1 ms` via Git-native sync.
`chinwag tasks blast-radius`	`0 Cr`	Computes `.codegraph` `fan_in`, `fan_out`, and selective test targets for a `--file-scope` glob.
`chinwag tasks split`	`50 Cr`	Invokes Chinwag Delivery-2 to decompose a ticket (`p90 > 150 LOC`) into disjoint atomic sub-tasks.
`chinwag tasks finops`	`0 Cr`	Prints the rolling organization credit ledger, cache hit rate, and 7-day code survival (`SURV`) summary.
`chinwag tasks pause`	`0 Cr`	Activates `EmergencyBrakePolicyV1` (`--all` or `--task <ID>`) to halt active subagent dispatch in `< 100ms`.

`chinwag task` Lifecycle Commands

1. `chinwag task create`

Creates a new signed TASK-*.md specification in <org>/chinwag-tasks and pushes a card to GitHub Projects v2 or Linear:

chinwag task create \
  --id TASK-204 \
  --title "Enforce strict Ed25519 verification on webhook ingress" \
  --file-scope "crates/webhook-ingest/src/**" \
  --verify-cmd "cargo test -p webhook-ingest" \
  --budget-cap 250

2. `chinwag task claim`

Acquires an exclusive, cryptographically signed --file-scope lease (WP-02) and provisions an isolated Shadow jj workspace (WP-01):

chinwag task claim TASK-204 \
  --actor "$CHINWAG_ACTOR" \
  --file-scope "crates/webhook-ingest/src/**" \
  --ttl 45m

Exit Codes:

0: Lease acquired and Shadow jj workspace mounted at .chinwag/workspaces/TASK-204/.
23: ERR_LEASE_CONFLICT · another active <SEAT>#<INSTANCE> holds an overlapping glob lease (T_coalesce collision).

3. `chinwag task fanout`

Decomposes a parent issue into parallel child leases (--wave) and dispatches subagents across disjoint file scopes:

chinwag task fanout TASK-300 \
  --max-subtasks 3 \
  --verify-disjoint

4. `chinwag task checkpoint`

Snapshots the current Shadow jj working tree, runs local H1..H3 pre-handoff hooks (0 Cr), and updates the task heartbeat:

chinwag task checkpoint TASK-204 --message "Pass unit and property tests for verify_strict"

5. `chinwag task complete`

Runs all mandatory chinwag.workflow.yaml gates (H1..H5, chinwag ui-gate if UI files changed), seals the completion receipt with the seat's Ed25519 key, releases the --file-scope lease, and updates GitHub Projects v2 / Linear:

chinwag task complete TASK-204 \
  --actor "$CHINWAG_ACTOR" \
  --seal-cwcard ./artifacts/TASK-204.cwcard.png

Next Steps

Next: CLI & GraphQL Reference: chinwag board
Ready to automate your task lifecycle? Reserve Your Organization Credit Pack →

Edit this page

teleport, shroud & vault

Teleport uncommitted Shadow jj working trees across machines with K1+K2 HPKE encryption (chinwag teleport), freeze org repositories instantly (chinwag shroud), and connect the 20-byte zero-knowledge scrimmage bridge (vault).

chinwag board & GraphQL

Complete reference for chinwag board init, push, sync, and scoreboard, plus the GitHub Projects v2 and Linear GraphQL synchronization schemas.