The commands a v4 setup actually uses. Everything supports --help; agent-facing commands offer --json (stdout = exactly one JSON object).
| Command |
Does |
kj init |
Config + rules + quality tooling. Agent-safe: falls back to defaults without a TTY, --json summary. |
kj env install |
Writes the method playbook into CLAUDE.md / AGENTS.md / GEMINI.md (--target) and builds the RAG index (--no-rag). |
kj harden |
Git hooks (lint, commit policy, gate runner), configs, CI workflows. Chains your previous global hooks. |
kj review --install-gate |
Enables the pre-commit review gate (tracked marker). |
| Command |
Does |
kj rag query "<q>" |
Semantic search over the project (auto-refreshes on drift). |
kj brief <role> |
Mission + invariants + deliverable of a role. No role → list. |
kj review --staged |
Sonar pre-gate on the changed files (BLOCKER/CRITICAL reject deterministically), then cross-AI review; verdict bound to the diff’s sha256 and stamped with its workspace. Exit 0/1. |
kj worktree start|list|done <slug> |
Isolated task lanes: worktree + feat/<slug> branch + dependency bootstrap; done removes a merged lane. |
kj review --check |
Is there an approved verdict for the exact staged diff? (What the hook runs.) |
kj solomon --position "<why>" |
Third-AI arbitration of a rejected verdict. Exit 0 approve / 1 reject. |
kj agent run <agent> "<task>" |
Delegate a task to another AI and print its output. |
kj report-issue --title "<t>" |
File a sanitized kj bug upstream. Never publishes without --publish. |
| Command |
Does |
kj check |
Environment health, 13 checks. |
kj doctor |
Deeper diagnosis with fixes. |
kj report |
Last session’s summary, budget, iterations. |
kj board |
HU Board dashboard (when state_backend: hu-board). |
kj gain |
Token savings analytics. |
| Command |
Does |
kj run "<task>" |
The classic subprocess pipeline — see Headless mode. --non-interactive (or KJ_NON_INTERACTIVE=1) auto-answers safe gates; FAIL findings stop with exit 1. |
kj autorun <spec> |
Spec → plan → run every story → outcome report, unattended. |
Everything else (kj advanced lists ~30 more) belongs to the headless pipeline and power users — documented in the V3 historical archive (here, clearly marked as legacy).
