CLI reference

Pre-1.0

Harnery is still pre-1.0; the surface below is documented but still settling. Pin a specific minor version (harnery@^0.31.0) and read the CHANGELOG before each upgrade.

Every command below links to its own page. Run harn <command> --help for the live flag list.

Coord layer

• harn agents: heartbeats, peers, claims, task focus
• harn council: convene a temporary group for multi-round deliberation
• harn journal: per-agent markdown journal that survives compaction
• harn decision: decision docket: file/resolve decisions instead of blocking on a human
• harn work: durable objectives across workflow attempts, with proof-derived reconciliation
• harn governor: bounded specialist-team loops over durable-work dependency graphs
• harn checkpoint: durable continuity capsules that survive context compaction
• harn agents context: one-screen orientation snapshot (self, repo, peers)
• harn presence: read/set mobile vs office presence

Adapters + workflows

• harn adapter: registered Claude/Codex/Cursor capabilities and offline conformance bench
• harn policy: validate host-enforced workflow policy documents
• harn run: bounded, schema-gated multi-adapter workflow scripts
• harn approval: inspect and resolve durable run-policy approvals

Files + code navigation

• harn grep: monorepo-aware code search with sensible default excludes
• harn outline: code outline via the TS AST (PHP/Python by regex)
• harn callers: find references to a symbol, classified by kind
• harn toc: markdown header outline
• harn section: extract one markdown section by header
• harn file-history: concise per-file git log with line impact
• harn config-get: read one value from a JSON/YAML config by dotted path
• harn edit-batch: one find/replace across many files in a single call

Web ops

• harn browse: Playwright-driven browser automation + visibility/layout checks
• harn browse-ai: accessibility-tree snapshots with element refs
• harn fetch: cookie-aware HTTP with a shared jar
• harn read: HTML → markdown via Readability + Turndown
• harn cookies: manage the shared cookie jar

Utilities

• harn tokens: offline token counting (o200k_base)
• harn eml: Gmail .eml → clean chronological markdown
• harn env: runtime + tooling environment report
• harn docs: markdown freshness, frontmatter, lint, sweep, and index
• harn devtools: local Claude Code / Codex / Cursor status

Lifecycle

• harn init: wire harnery into a project
• harn deinit: unwire harnery from a project
• harn web: standalone Next.js dashboard
• harn backup: restic-backed snapshots
• harn sync: Google Drive-backed cross-machine sync
• harn doctor: runtime + dependency check
• harn tunnel: IP-gated Cloudflare quick tunnel(s); run several at once with --name
• harn completion: shell tab completion (bash/zsh/fish)