Commands by task

Every keryx CLI verb and every keryx shell command, grouped by task — the same grouping keryx help and the OpenTUI shell's /help modal use (src/standard/help-groups.ts, flow 303).

Generated. Do not hand-edit: regenerate with bun scripts/generate-commands-by-task.ts, and src/standard/commands-by-task.test.ts fails when this page drifts from the table it is generated from.

Start here

CLI command	Summary
keryx init	Initialize .metaproject in the current project.
keryx status	Show local Metaproject status.
keryx shell	Start the interactive TUI agent harness (--no-tui or --chat to opt out).
keryx help	Grouped command help by task — keryx help [group|command].
keryx doctor	One-page health check: version, Bun floor, ripgrep, sandbox, providers, MCP, integrations, standard, worktrees, graph/wiki freshness.
keryx setup	Print the Metaproject preparation guide: init, refresh, or repair.

Shell command	Summary
/help	Show available commands, grouped by task.
/doctor	Same one-page health check, inside the session.
/setup	Same preparation guide, inside the session — prints steps, runs nothing.

Connect a model provider

CLI command	Summary
keryx auth	Subscription login (SuperGrok, ChatGPT Plus/Pro, GitHub Copilot) and API-key status.
keryx providers	Providers this operator has configured, the live model/balance catalog (status), and cross-family review eligibility.
keryx routing	Category -> model routing table (list, set, unset, trust), the model-profile catalogue (profile list, profile set), and real measured task cost (stats).
keryx external	Keep private work in-house: block Jev/TypeSafe and other listed providers/models (on|off|status|list).

Shell command	Summary
/connect	Switch provider; row buttons test/disconnect it.
/routing	Route task categories to models — a flat, searchable list across every connected provider.
/search-provider	Configure and test a web search provider.
/search-connect	Select a connected web search provider.
/provider	Switch provider — /provider , or no arg to re-select.
/external	Block/allow sending private work to Jev/TypeSafe and other listed providers/models — /external [on|off].

Look and feel

Shell command	Summary
/theme	Open the theme picker — /theme [name] applies immediately.
/settings	Every setting in one place, each with its On/Off or value buttons.
/model	Switch the model.
/models	Pick a model for the current provider (numbered menu).
/mode	Show or switch the permission mode — /mode [ask|trust|auto]. Round limit: 40 rounds per turn, 200 in trust, 200 in auto and in automatic review; KERYX_AGENT_MAX_ROUNDS overrides.
/think	Expand the last reasoning block — /think [auto|expand|hide|collapse].
/reasoning	Show or set reasoning effort — /reasoning [off|minimal|low|medium|high|xhigh|max].

Working in keryx shell

CLI command	Summary
keryx sessions	List or export per-project shell sessions.

Shell command	Summary
/sessions	Open the session list and switch to one.
/resume	Resume a prior session in this project.
/new	Start a new session (old kept on disk).
/clear	New session (alias of /new).
/compact	Compact model context — /compact [focus] (archive kept).
/trail	The tool calls this session recorded (what stays when older rounds leave the request) — /trail [count] [tool=NAME] [file=TEXT] [from=STEP] [to=STEP].
/notes	The notes the model keeps for itself (the facts that survive older rounds) — /notes [key].
/rewind	Roll back files and/or conversation to the start of an earlier turn — /rewind [N [files|history|both]]; snapshots cover the work tree only.
/copy	Copy the newest transcript block to the clipboard.
/expand	Expand the last tool output block.
/status	Show session identity, context window, limits, workspaces, and flows.
/queue	Manage the main queue — /queue [N] (N = qN position, default 1).
/tasks	List supervised shell tasks — /tasks [output [cursor] | kill ].
/interrupt	Interrupt the running main agent turn.
/exit	Leave the shell (/quit works too).
/game	Games against the model — /game [seconds] raises the model-turn deadline.

Project knowledge

CLI command	Summary
keryx gdgraph	Build and query the code dependency graph.
keryx ctx	Run compact context commands and save raw output.
keryx wiki	Manage the local project knowledge base.
keryx memory	Store and search long-term project memory.
keryx orient	Emit a bounded graph + wiki startup block, or install it as a turn-start hook.
keryx skills	Manage bundled Metaproject working skills.
keryx stack	Deterministic, offline stack detection — keryx stack detect.
keryx bundle	Portable bundle export/import of skills, rules, agents, memory and hooks across scopes and harnesses.

Managed work

CLI command	Summary
keryx flow	Agent-first flow lifecycle (Task Manager).
keryx job	Agent-first job packages (job-orchestrator state, steps, documents).
keryx review	Managed review packages and lightweight report-only review mode; review ledger build writes the research ledger the completion gate demands.

Shell command	Summary
/flows	Browse project flows and inspect one.
/ac	Check the active flow's frozen acceptance criteria (advisory, cached) — same modal as /flows, AC tab.
/review	Show project-wide items needing review (proposals, blocked sessions).
/ci	Failed CI runs/jobs of the current branch's PR, each with an advisory triage and its deterministic-signal evidence.
/conform	Check a PR, a review report, or a diff against a reference document's clauses, with Jev.
/risk	Risk map of the working diff's hunks — deterministic facts plus Jev per risk dimension, ranked, highest risk first.
/scenarios	Which user scenarios the working diff likely changes — deterministic scenario/code links plus Jev, ranked.
/jevrules	Check the working diff's hunks against every applicable project rule clause, with Jev, grouped by rule.
/staledocs	List doc sections that likely went stale because of the working diff, with Jev.
/flow	Show a flow's origin, or set it with a reason — /flow origin [] | /flow origin --reason "...".
/opencomments	List open PR review comments with a Jev resolved/still-open/escalation label — /opencomments .
/contract	Check PR-description claims and a linked flow's frozen acceptance criteria against the working diff, with Jev.
/triage	Advisory annotations — severity calibration, duplicate-merge candidates, verifier queue order — over the latest review package, with Jev.
/guard	Opt-in turn guard: after a turn, checks whether the request was done and catches a reply that contradicts the tools — /guard [on|off].
/route	Opt-in routing classifier: each request runs on its routing category's model — /route [on|off].
/editguard	Jev EDIT GUARD status, threshold and recent flags for the Claude Code PostToolUse hook, with a toggle.
/jevprofile	Every review.jev.* setting next to its measured verdict; toggle one or apply the recommended profile.
/plan	Toggle read-only mode — /plan [on|off].
/goal	Deterministically start a goal — /goal [--workspace ] [--auto [N]].

Automation

CLI command	Summary
keryx trigger	Fire one declared project trigger (git hook, cron line, CI job) — one pass, one exit code.
keryx schedule	Scheduled agent tasks in the background: create (with confirmation), list, pause, resume, remove; add --digest makes a GitHub and board digest that keryx serve sends to Telegram.
keryx approvals	Pending remote approvals: list them, allow or deny one call, once (the local answer path of keryx serve).
keryx permissions	The saved shell rules an Always answer leaves behind: list them (honoured or not, with the reason) and remove one.
keryx governance	Read-only report over already-recorded spend, confirmations, signatures and gate outcomes.
keryx decisions	Recommendation journal: record each agent question with options and its recommendation, the human's choice, and report how often they agree (a third are asked blind). A question also takes your own text: the last row "Свой ответ…" in the shell, the "✍ Свой ответ" button in Telegram, and Tab after an option adds a typed reason.
keryx intake	GitHub work intake: tickets, review requests, failed CI, PR comments and board movement as cards in Telegram; status, pause, poll by hand, and a usefulness report.
keryx research	Part 1 materials: sync refreshes the -latest counts, the text-free decisions export and the status page next to the catalog; no commit, only when the content changed.
keryx product	The product's intent as a derived index, and the intents closed in code that nobody looked back at.
keryx hooks	Keryx shell lifecycle hooks: list/validate/test, trust project hooks, enable/disable a registration.
keryx learn	Self-learning loop: observe, extract, review, accept/reject, apply, promote, graduate, prune.
keryx remote	Preview how Telegram replies are rendered (tables, lists, rules) in every mode, with no network: format-sample.

Shell command	Summary
/triggers	Declared triggers: last outcome, spend, reservations — run one now.
/schedule	Schedule a background agent task — shows a confirmation card first (keryx schedule add).
/schedules	Scheduled tasks: next run, last outcome, report — pause, resume, run now, delete.
/autoreview	Autonomous PR review with nobody at the keyboard: start, list, stop, arbiter — phase, rounds and tokens in the sidebar; arbiter lists what the question arbiter decided.
/approvals	Pending remote approvals with scope, consequence and expiry — allow or deny one call, once.
/permissions	The saved shell rules (what Always remembered): honoured or not, session grants — remove one.
/external-diff	External agent write runs awaiting review: patch and flagged paths — apply (typed hash prefix) or discard.
/governance	Flows with their summary and stated effect — check an open one, complete it once the check passes and the PR is merged; the last report in its own tab, or run one in the background.
/decisions	Recommendation journal report: match share by mode and stage, the deviations with their reasons, and your own answers and typed reasons in full (marked ✍ in the sidebar row).
/product	Intents closed in code that nobody looked back at, with their outcome criteria.
/reviews	Managed pull request reviews: findings by outcome, precision, resolved before merge.
/remote-control	Drive this session from a Telegram topic: send lines, get replies, answer approvals and questions (an option button, or "✍ Свой ответ" and a reply with your own text). Off by default; [name|off|status].
/history	Post the last messages of this session to the Telegram topic, oldest first. [N], 1 to 20; 10 by default.
/channels	Connect, test or disconnect Telegram for this machine: bot token, one-time code, group. [status].
/intake	GitHub work intake: cards that wait for your decision (take, decline, later), pause or resume the poll, poll by hand. [status|list|pause|resume|poll].
/rendering	How Telegram replies are written: tables and lists as rich messages or HTML, with a fallback. [auto|rich|html|plain].
/remote-policy	Telegram defaults for a turn started there: mode ask|trust, run limit, approval wait. Never changes the shell's /mode.

External agents, ACP and MCP

CLI command	Summary
keryx acp	Speak ACP v1 (newline-delimited JSON-RPC) over stdio, for an ACP client (e.g. an editor).
keryx agents	Manage optional global agent bootstrap instructions.
keryx mcp	Retired spelling of serve-mcp / integrate; still works, names its replacement.
keryx integrate	Wire this project into an editor or agent as an MCP server.
keryx integrations	Install, audit and uninstall Keryx's hooks and instructions in another coding agent (see also /integrate, unrelated).
keryx serve-mcp	Expose Metaproject services over the Model Context Protocol (opt-in).
keryx bus	Agent bus: list peers and leases, read the log, send a message, prune.
keryx workspace	Shared Agent Context: workspaces, FWK reads, propose/review (module sac).

Shell command	Summary
/delegate	Hand a task to an external agent CLI — /delegate .
/external-agents	Turn the external agent runtime on or off — /external-agents [on|off]; not the /external privacy switch.
/demote	Move a running foreground task to the background — /demote .
/mcp	MCP servers keryx is connected to — status, connect/disconnect; /mcp trust list, /mcp trust revoke or all (session trust).
/integrate	Wire this project into an editor over MCP (keryx integrate; see also keryx integrations).
/bus	Message or view peers on the project agent bus — /bus @ .
/workspace	Show this session's SAC workspace and its slates.

Maintenance and diagnostics

CLI command	Summary
keryx health	Aggregate code quality signals and run the quality gate.
keryx test	Analyze testing context and normalize test reports.
keryx standard	Validate the workspace against the Metaproject Standard.
keryx update	Refresh managed service files without touching data artifacts.
keryx sync	Reconcile graph/wiki/memory with the current code, and wire the git hooks.
keryx security	Policy-based scanning, redaction, guardrails and audit reports.
keryx dashboard	Build or open the project admin dashboard.
keryx dash	Rebuild and open .metaproject/keryx-dashboard.html.
keryx metrics	Provenance-aware execution observability: run records, baselines, benchmarks.
keryx sandbox	Report OS sandbox launcher availability and the per-capability containment matrix.
keryx modules	View and toggle Metaproject modules (interactive).
keryx projects	Inspect the user-global registry of initialized projects.
keryx serve	Loopback-bound authenticated HTTP entry (off by default; read-only routes).
keryx rules	Sync root AGENTS.md/CLAUDE.md into high-priority project rules.
keryx harness	Run a single provider turn (harness run) and print structured events.
keryx version	Check whether a newer npm release is available.
keryx retention	Bound stores that grow without bound (gdctx raw/artifacts, owner write-conflict sidecars).
keryx forgetting	Read the deletion trail — was this removed, or did it never exist?
keryx commands	Agent-callable command registry (intents, args, output, model usage).