CLI overview
What every ivar command has in common — the machine-readable contract, colour handling, and the command groups.
The harness calls these commands for you. This section documents them for when you want to run one yourself, script one, or understand what a slash command just did.
curl -fsSL https://ivar.run/install?ref=docs-cli-reference | shivar --help
ivar <group> <command> --helpCommand groups
| Group | What it owns |
|---|---|
| Hall | init, sync, status, doctor, cleanup, migrate, upgrade, repo, provider |
| Feature | feature create, promote, deliver, integrate, and the rest of the feature lifecycle |
| Session | session start, list, connect, convert, stop, relay, prune |
| Graph | graph index, explore, callers, impact, affected, view, mcp, and the other graph queries |
| Memory | memory status, query, reindex, lint, review, handoff, clean, and the capture and brief hooks |
| Skill | skill create, add, sync, list, status, update, detach, remove, enable, disable, doctor |
| MCP | mcp add, edit, remove, auth, status |
| Feedback | feedback add, feedback list, feedback show, feedback submit |
| Agent | agent sync, agent status, agent run, agent logs, agent feedback |
ivar plan is also a group, driven almost entirely by | |
/ivar-plan rather than by hand. |
--json
Every command takes it.
ivar status --jsonOne value, two renderings
--json prints exactly the value the command computed. The human-readable
text is a rendering of that same value, so the two can never tell you
different things — script against the JSON.
--color
auto (the default) follows NO_COLOR, then FORCE_COLOR, then whether the
stream is a terminal — a pipe or a redirect gets none. always and never
override all of that.
Only labels are ever coloured; values never are, so --json output is
unaffected either way.
Feedback
Feedback commands capture, list, inspect, and submit structured defect reports and proposals.
# Record a defect or proposal via stdin
ivar feedback add --title "Guard false positive" --kind bug --file - << 'EOF'
## Symptom
Guard denied write to promoted repository.
EOF
# List recorded entries
ivar feedback list
# Inspect an entry with sensitive path redactions
ivar feedback show 001-guard-false-positive --redacted
# Submit to GitHub issues (requires interactive confirmation)
ivar feedback submit 001-guard-false-positive