Recurz CLI
One command line.
Every product.
recurz reads and runs everything you can do on the site, from the terminal or a script. Every command prints plain lines when piped and the API's own JSON with --json.
# Install
npm install -g @recurz/cli
# First run: sign in, register this machine and start the collector
recurzmacOS and Linux. One binary for every product; no product ships a CLI of its own.
318 commands across the five products: Works today 197 · Next 7 · Planned 114
Learn it once
Every command has the same shape, and a verb means the same thing on every noun.
recurz <noun> [<sub-noun>] <verb> [TARGET] [flags]
recurz session # a bare noun lists
recurz session 91dd # a noun and a target shows
recurz finding list --kind loop
recurz eval plan create checkout@v3 --bar 1pp- Leaving out the verb never writes. A bare noun and a noun with a target only read.
- Spending asks first.
runandreplayprint a quote before they start. - Any id works anywhere. Ids carry their kind (
ses_…,fnd_…), soshow,openandtracetake any of them. - Product names are help.
recurz tracezprints every Tracez command.
Read
list show open trace watch diff compare
Change
create edit delete add remove release import export check apply dismiss pin merge detect ack resolve rate
Spend, quoted first
run replay train
Live agents
nudge pause resume stop cancel attach
Everyday words
Short words for what you do most. Each shortcut does exactly what its long form does.
| Command | What it does | Status |
|---|---|---|
recurz feed [--since 24h] [-f] | What changed across your agents, newest first same as recurz story list | Works today |
recurz inbox | What needs you, one key to act same as recurz story list --needs-you | Works today |
recurz top [--window 15m] | Live agents on every machine, full screen same as recurz agent list --live | Works today |
recurz ask QUESTION | Answers about your agents, sessions and spend, with sources | Planned |
recurz search QUERY [--brief] [--repo .] | Text across sessions, notes, memories and artifacts | Planned |
recurz show ID | Anything by id; today sessions by id or title words | Works today |
recurz open ID | Anything by id in its web page; today sessions | Works today |
recurz trace ID [--from N] | Every step of a session (later also a task attempt) | Works today |
recurz status | Is everything working: ingestion today; sign-in, collector, Steerz and inbox next | Works today |
recurz doctor | Check this machine and the org, with a fix for each failure | Planned |
recurz install [--no-modify-path] [--no-collector] | Put recurz on this machine (~/.local/bin, on PATH) and start collecting; npx @recurz/cli install runs it | Works today |
recurz init | Set up this machine: sign in, harnesses, collector, backfill, Steerz, statusline | Planned |
recurz wrap -- CMD | Collect one agent run with an ingest key and nothing installed same as recurz collector wrap | Planned |
recurz login [--device] [--org ORG] | Sign in to Recurz in your browser, or with a code on a machine without one, in your personal org or the one named | Works today |
recurz bootstrap [--org NAME] [--invite EMAILS] [--role member|admin] [--check] | Set up your org from nothing, or check one: sign in, pick or make the team's org, register this machine, invite people, add starter lessons, link the rest | Works today |
recurz logout | Sign out on this machine and revoke the sign-in | Works today |
recurz whoami | Who you are signed in as, and the org | Works today |
recurz context [PATH…] [--command CMD] [--error TEXT] [--repo REPO] | What your org already knows about these files, this command or this error: lessons, fixes, earlier sessions and memory | Works today |
recurz resume [--branch NAME] [--pr N] [--repo REPO] | Pick up a branch or PR where the last agent stopped: its newest handoff note, then the earlier sessions on it, how each ended and its last error | Works today |
recurz handoff TEXT… [--branch NAME] [--pr N] | Leave a note for whoever picks up this branch or PR next; recurz resume shows it first | Works today |
recurz cost [--budget USD] | What this session has cost so far, the org's spend today and the credits left | Works today |
recurz report helped|wrong|confusing|broken|idea lesson|fix|tool|session|answer [ID] TEXT | Tell Recurz a lesson, fix, tool or answer helped or was wrong; lessons show these beside their verdicts | Works today |
recurz analyze [--deep] [--json] [--plain] [--own-key [--cap DOLLARS] [--yes]] | What Recurz could fix in the agent work already on this machine: the loops your agents keep doing, the spend that bought nothing and what could be evaluated on your own sessions, each with how many sessions it showed up in; read locally, no account. Nothing is uploaded unless you ask `--own-key` (or `y`) to have a model read the failing rows with your own API key, scrubbed, under a spend cap shown first. `recurz receipt` is its old name | Works today |
recurz transcripts [--since WHEN] [--show] [--json] [--plain] | Everything the agent transcripts on this machine say, all time, and which ones Claude Code is about to delete; read in place, nothing written or uploaded, no account | Works today |
recurz recall search TEXT [--since WHEN] [--until WHEN] [--harness claude|codex] [--cwd TEXT] [--branch TEXT] [--limit N] [--paths] [--json] | The earlier sessions on this machine that did something, each with why it matched and the turn to open; exact ids, file names and error strings match anywhere, tool output included; read locally, nothing uploaded, no account | Works today |
recurz recall show SESSION [--prompts | --tail N | --around TURN [--window N]] [--full] [--json] | Read one session from this machine: its prompts word for word, where it ended, or the turns around one moment; secrets scrubbed | Works today |
recurz recall related [--here PATH] [--since 90d] [--harness claude|codex] [--json] | The sessions on this machine that worked in this folder, on this branch or on the files changed here, with no query | Works today |
recurz question ask QUESTION [--option TEXT]… [--recommend N] [--context TEXT] | Ask a person in your org a call you shouldn't make alone; it waits in their Home inbox while you keep working | Works today |
recurz question show QUESTION [--wait SECONDS] | A question you asked and its answer, waiting for it if asked to | Works today |
recurz question list [--session ID] [-q] [--json] | Your questions to people, answered or still open | Works today |
recurz question cancel QUESTION | Take back a question you no longer need answered | Works today |
Collectorz
Collect from every harness on this machine. About Collectorz →
| Command | What it does | Status |
|---|---|---|
recurz collector ARGS… | Runs recurz-collector with these arguments (status, pause, resume, logs, install…) | Works today |
recurz collector wrap -- CMD | Collect one run with nothing installed; the agent's exit code passes through | Planned |
recurz device list | Your machines signed in to the org | Works today |
recurz device show DEVICE | One of your machines and when it was last seen | Works today |
recurz device edit DEVICE --name | Rename a machine | Planned |
recurz device revoke DEVICE [--yes] | Sign one of your machines out (asks first) | Works today |
recurz harness list | Each harness and whether it is wired to Recurz (MCP server and rules), for you and in this repo | Works today |
recurz harness connect NAME [--project] [--dry-run] | Wire a harness to Recurz: recurz mcp in its MCP config and rules that call recurz_context (Cursor, Gemini CLI, OpenCode, VS Code, Windsurf, Amp, Kiro, Qwen Code, Antigravity, Oh My Pi, and Pi with an events extension), or the steps for one whose config it doesn't edit | Works today |
recurz harness rules | The rules connect writes, to paste into any other harness's instructions file | Works today |
recurz harness disconnect NAME [--project] [--dry-run] | Take out what connect added, leaving the rest of each file as it was | Works today |
Tracez
Every session, its memories, artifacts, retros and spend. About Tracez →
| Command | What it does | Status |
|---|---|---|
recurz session list [QUERY] [--since WHEN] [--until WHEN] [-q] | Sessions, or the ones whose title or transcript contains QUERY, last active between --since and --until | Works today |
recurz session table [--outcome merged|open|closed|none] [--finding KIND] [--agent A] [--model M] [--repo R] [--person P] [--cost BAND] [--since 7d|30d|90d|all] [--json] | Sessions filtered and counted by PR outcome, findings, agent, model, repo, person and cost, with cost per merged PR | Works today |
recurz session ask QUESTION [--time-zone TZ] [--json] | Evidence for a question about your sessions, each row citing the session and turn; no model call | Works today |
recurz session prs [--since WHEN] [--until WHEN] [--state merged|open|closed|all] [--q TEXT] [--limit N] [--json] | Pull requests with their state, times and the sessions that opened, pushed or committed to them | Works today |
recurz session show SESSION | What happened: passages, loops, money, files | Works today |
recurz session trace SESSION [--from N] | Every step at full terminal width | Works today |
recurz session open SESSION | The session in Tracez | Works today |
recurz session sources SESSION | Which machines and files a session was read from, and when each last arrived | Works today |
recurz session export SESSION --format claude|codex [--version V] [-o FILE] | The session as a file Claude Code or Codex can resume, under a new id so resuming forks it | Works today |
recurz session import PATH [--harness claude|codex|pi|oh-my-pi|prime] | Send transcript files, or every .jsonl under a folder; sending one again changes nothing | Works today |
recurz session edit SESSION [--title TEXT] [--project P | --new-project NAME | --unfiled] | Retitle a session, or file it to a diary project | Works today |
recurz session verify SESSION | Check a session's turns against the org's hash chain: verified, redacted or changed | Works today |
recurz session redact SESSION [--yes] | Remove a whole session's text for good; asks first | Works today |
recurz session delete SESSION [--yes] | Delete a session for good and keep it from coming back; asks first | Works today |
recurz session hold SESSION | Exempt from retention and deletion | Planned |
recurz session unhold SESSION | Lift a legal hold | Planned |
recurz project list | Sessions filed by repo and project | Planned |
recurz project show PROJECT | One project: goal, live agents, sessions, spend | Planned |
recurz project edit PROJECT | Rename or merge a project | Planned |
recurz memory list [--harness --scope --kind --repo] | The CLAUDE.md, AGENTS.md, skills and memories agents load | Works today |
recurz memory show ID | One memory file's current text | Works today |
recurz memory diff ID@a ID@b | How a memory file changed | Planned |
recurz memory search [QUERY] [--category --project] | Memory files by what they say, newest change first, with what changed last | Works today |
recurz memory overview | What your agents know and made, at a glance | Works today |
recurz memory check | Drifted, stranded, duplicated and out-of-date instructions across agents | Works today |
recurz memory coverage | How many of your global rules each agent loads, per machine and harness | Works today |
recurz memory propose KIND --instruction TEXT [--why --title --scope] | Propose a rule, skill or fact; nothing changes until a person accepts it | Works today |
recurz memory history MEMORY | Every version of one memory file, and its copies on other machines | Works today |
recurz proposal list [--status --source --scope] | Proposed memory edits waiting on a person, and where each came from | Works today |
recurz proposal show PROPOSAL | One proposed edit and the diff of every file it would change | Works today |
recurz proposal accept PROPOSAL [--text] [--note] | Accept a proposed edit and write it to the machines that opted in; only whose memory it is, or an org owner or admin | Works today |
recurz proposal reject PROPOSAL [--note] | Reject a proposed edit; proposing it again keeps it rejected | Works today |
recurz rollout list [--state] | Accepted memory edits and where each stands on every machine | Works today |
recurz fact list [QUERY] [--project] | Dated facts your agents recorded about code and systems | Works today |
recurz wiki list | What your agents know about each project, one page each, with what each page cites | Works today |
recurz wiki show PAGE | One project's page: what bit agents before, how it works, its decisions and plans, every line with its source | Works today |
recurz note list [QUERY] [--area --path] | Your repo's shared agent memory: its areas, the notes that match words, or the notes about files | Works today |
recurz note show NAME | One repo memory note in full, with a link to it at the snapshot's commit | Works today |
recurz artifact list [SESSION] [--all] | Files agents published, showed or sent, and uploads | Works today |
recurz artifact show ID | One artifact | Works today |
recurz artifact import FILE --session ID [--name NAME] [--json] | Import a file into an existing session as an account upload | Works today |
recurz artifact recover ID SESSION SEQ [--capture-sha256 SHA256] [--json] | Recover a catalog entry or old captured source from publication evidence | Works today |
recurz artifact catalog ID FILE [--json] | Apply a version-pinned repository-document catalog correction without deleting source | Works today |
recurz artifact restore ID FILE [--replace-sha256 SHA256] [--json] | Restore an exported source on its existing artifact record | Works today |
recurz artifact export ID [-o DIR] [--capture SEQ.SHA256] | Download an artifact under its own name; never overwrites | Works today |
recurz artifact bind-resources ID --capture SEQ.SHA256 ARCHIVE --archive-capture SEQ.SHA256 [--json] | Attach an owner recovery archive containing byte-identical original HTML | Works today |
recurz artifact resources ID [--capture SEQ.SHA256] [--json] | List original companion files from an artifact’s captured archive | Works today |
recurz artifact search [QUERY] [--category --asked --project --limit] | What agents made, one line per document at its newest version | Works today |
recurz artifact lineage ARTIFACT | Every version of one document, and how each is filed | Works today |
recurz retro list [--limit] | What retros say to change, across sessions | Works today |
recurz retro show SESSION | One session's retro | Works today |
recurz retro run SESSION | Retro a session now; fixes land in retro show | Works today |
recurz usage [--by model|harness] [--per day|week|month] [--since] | Tokens and estimated cost over time; --by project|person|hour and --storage planned | Works today |
recurz org verify [--json] | Check the whole org for tampering: every seal of its hash chain, its signed head and every session | Works today |
Observerz
Live agents, findings, guardrails and alerts. About Observerz →
| Command | What it does | Status |
|---|---|---|
recurz agent list [--window 15m] [--live] | Agents and their state, one line each (top without the full screen) | Works today |
recurz agent show AGENT | One agent as a line of words, with its tree and tasks | Works today |
recurz agent watch AGENT | Tail an agent's turns live | Planned |
recurz agent nudge AGENT MESSAGE | Send a message into the running agent | Planned |
recurz agent pause AGENT | Hold it at its next hook | Planned |
recurz agent resume AGENT | Let it go on | Planned |
recurz agent stop AGENT | End it at its next hook | Planned |
recurz agent attach AGENT | Take it over in this terminal | Planned |
recurz finding list [--since 24h] [--kind loop|stall|…] | Loops, stalls, hangs, early stops and risky actions, with evidence | Works today |
recurz finding show FINDING | One finding and the fixes it suggests | Works today |
recurz finding ack FINDING | Mark it seen | Planned |
recurz finding dismiss FINDING | Turn it down | Planned |
recurz finding resolve FINDING | Mark it dealt with | Planned |
recurz finding rate FINDING useful|wrong|noise | Tune its detector | Planned |
recurz detector list | Every detector and what it caught | Planned |
recurz detector show DETECTOR | One detector, its thresholds and hits | Planned |
recurz detector edit DETECTOR | Change its thresholds | Planned |
recurz guard list | Guards, their mode, how often each was right, and whether it is ready to enforce | Works today |
recurz guard show GUARD [--receipts N] | One guard: its rules and its newest receipts | Works today |
recurz guard create NAME --when … --do nudge|block|stop | A new guardrail; it starts in shadow | Planned |
recurz guard edit GUARD | Change a guardrail | Planned |
recurz guard promote GUARD | Shadow to on, once one of its rules is ready | Works today |
recurz guard rollback GUARD | Back to shadow | Works today |
recurz guard grade RECEIPT right|wrong|clear | Say whether a guard was right in one receipt | Works today |
recurz guard delete GUARD | Delete a guardrail | Planned |
recurz lesson list [-q] | Scoped lessons the hook shows agents, with each one's verdict | Works today |
recurz lesson add TITLE --text … [--path GLOB] [--command RE] [--error RE] [--mode M] [--share S] | --starter | A new lesson, or Recurz's starter set; each starts in rollout to half of sessions | Works today |
recurz lesson propose TITLE --text … [--path GLOB] [--command RE] [--error RE] [--why TEXT] | Propose a lesson for the next agent; it stays off until an owner or admin turns it on | Works today |
recurz lesson edit LESSON [--title …] [--text …] [--path GLOB] [--command RE] [--error RE] [--mode rollout|on|shadow|off] [--share S] | Change a lesson; new text or triggers start a new verdict | Works today |
recurz lesson delete LESSON [--yes] | Delete a lesson | Works today |
recurz alert list | Alerts raised on loops, stalls and spend | Planned |
recurz alert show ALERT | One alert | Planned |
recurz alert ack ALERT | Acknowledge it | Planned |
recurz alert rule list | When to alert | Planned |
recurz alert rule create --on KIND … | A new alert rule | Planned |
recurz alert rule edit RULE | Change an alert rule | Planned |
recurz alert rule delete RULE | Delete an alert rule | Planned |
recurz alert channel list | Where alerts go | Planned |
recurz alert channel add pushover|email|slack|webhook … | Send alerts somewhere new | Planned |
recurz alert channel test CHANNEL | Send a test alert | Planned |
recurz alert channel remove CHANNEL | Stop sending there | Planned |
recurz digest [DAY | --period week [WEEK] | --project PROJECT] | The work diary: one day, a week, or where a project stands | Works today |
recurz storyline list [DAY] [--pokes] | The day's Storylines: your agents' work grouped by what you wanted, what is blocked, and what dropped with a drafted poke | Works today |
recurz prompt list [QUERY] [--project --day --limit] | Your own prompts to your agents, newest first | Works today |
recurz idea list [-q TEXT] [--kind --status --project --scope --sort --limit] | Your idea bank: things worth building, learning or exploring from your sessions | Works today |
recurz idea show IDEA | One idea and every place it came up | Works today |
recurz idea add TITLE [--summary --why --kind --status --project --note --promise] | Write an idea down | Works today |
recurz idea edit IDEA [--title --status --note …] | Change an idea's status, note or fields | Works today |
recurz idea share IDEA [--off] | Share an idea with your org, without your note | Works today |
recurz mood list [--days 30] | How you sounded in your prompts and why; only you see it | Works today |
recurz mood prompts [--mood --cause --directive --limit] | Your labeled prompts, newest first | Works today |
recurz mood correct SESSION TURN --mood M [--cause C] | --clear | Correct one prompt's mood | Works today |
recurz mood on | Start labeling your prompts | Works today |
recurz mood off [--yes] | Stop, deleting every label; asks first | Works today |
recurz work list [--range today|7d|30d] | Your projects ranked: what waits on you, each one's state, two weeks of sessions with PR days, folded count | Works today |
recurz work show PROJECT | One project's brief and its open items, with stage and criteria | Works today |
recurz work days [PROJECT] [--since 90d] [--columns C,C] [--json] | Projects day by day: sessions, steps, failures, spend, findings, PRs, deploys and asks | Works today |
recurz work sessions PROJECT [--item ID] [--since 90d] [--limit N] [--json] | A project's sessions with their steps, errors, spend, sub-agents, findings, PRs and the work items each worked on | Works today |
recurz work resolve PROJECT | Mark a project done; it folds away | Works today |
recurz work dismiss PROJECT | Drop a project; it folds away | Works today |
recurz work pin PROJECT [--off] | Pin a project to the top; --off clears its mark | Works today |
recurz work merge PROJECT --into PROJECT [--yes] | Merge one project into another; can't be undone | Works today |
recurz work rename PROJECT NAME | Rename a project; the model never renames it again | Works today |
recurz work detect | Score project detection again and refresh its suggestions | Works today |
recurz fix list [--from retro|observerz|steerz] [--repo] [--since] | Every proposed change with evidence and expected saving | Planned |
recurz fix show FIX | One fix, its evidence, and later whether it helped | Planned |
recurz fix apply FIX… [--pr] | Make the change, as a PR with evidence | Planned |
recurz fix dismiss FIX | Turn it down | Planned |
recurz hook HARNESS | The harness hook guardrails run through | Planned |
Steerz
Routes, policies, provider keys and models. About Steerz →
| Command | What it does | Status |
|---|---|---|
recurz limit list | Spend caps per org, product or key | Planned |
recurz limit create --scope … --monthly N --then reject|alert | A new spend cap | Planned |
recurz limit edit LIMIT | Change a cap | Planned |
recurz limit delete LIMIT | Delete a cap | Planned |
recurz route list [--since --agent --model --cache miss] [--by reason|model|class] | Which model took each call and why | Planned |
recurz route show REQUEST | One call: asked, routed, rule, cache, cost against the alternative | Planned |
recurz route classify < request.json | Class and confidence without calling a provider | Planned |
recurz policy list | Routing policies | Planned |
recurz policy show POLICY [--arms] | A policy, its arms, quality and cost per success | Planned |
recurz policy diff A B | What differs between two policies | Planned |
recurz policy create NAME | Draft a policy | Planned |
recurz policy edit POLICY | Edit a draft, rewrite rules included | Planned |
recurz policy release POLICY | Freeze a draft | Planned |
recurz policy replay POLICY --since 30d | Backtest on last month's real sessions | Planned |
recurz policy promote POLICY [--canary 10%] | Put it on traffic in stages | Planned |
recurz policy rollback POLICY | Undo the last promote | Planned |
recurz policy delete POLICY | Delete a draft | Planned |
recurz provider list | Every provider Steerz routes to, and which have your own key | Works today |
recurz provider show PROVIDER | One provider | Planned |
recurz provider add PROVIDER (key on stdin) | Bring your own key, checked then sealed | Next |
recurz provider verify PROVIDER | Check the key still works | Planned |
recurz provider remove PROVIDER | Delete the key | Planned |
recurz provider reset PROVIDER | Close an open breaker | Planned |
recurz model list [--provider P] | Every model you can route to, with list prices | Works today |
Verdictz
Evals, verdicts, loadouts and studies. About Verdictz →
| Command | What it does | Status |
|---|---|---|
recurz session rerun [SESSION] [--repo OWNER/NAME --pr N] [--world FILE] [--runs N] [--stub-model] [--minutes M] [--wait [MIN]] [--json] | Rerun one of your sessions from scratch in another world: the real harness on Recurz's solve box, told your first message; each rerun is its own Tracez session | Works today |
recurz session reruns [SESSION] [--limit N] [--json] | Your session reruns, newest first: status, world, and what each did | Works today |
recurz eval list [--archived] [--json] | Every current eval and its task count; --archived lists the Loadoutz-era ones instead | Works today |
recurz eval show NAME [--json] | One eval's versions, what changed in each, and its baseline runs | Works today |
recurz eval diff NAME@v2 NAME@v3 | Tasks added, removed and changed between versions | Planned |
recurz eval release NAME@v3 | Freeze a draft version | Planned |
recurz eval login [--no-browser] | Sign in to the Verdictz control plane in your browser; VERDICTZ_TOKEN overrides it | Works today |
recurz eval import FILE --format github --into NAME [--new --name TITLE] [--category C] [--disclosure withheld|public] [--watch] [--json] | SOURCE --format harbor --into NAME [--new --name TITLE] [--disclosure withheld|public] [--tasks K,…] [--limit N] [--skip-checks] [--watch] [--json] | Bring GitHub pull requests and issues into a draft version, one task each, or a Harbor suite (a folder, a .tar.gz, hf:, harbor:, prime: or github:), checked in Docker and held for review | Works today |
recurz eval import show ID [--watch] [--json] | Where one import stands: each URL's state, reason and task | Works today |
recurz eval export NAME@v2 --format harbor -o DIR | Write a version out | Planned |
recurz eval check SOURCE --format harbor [--tasks K,…] [--limit N] [--json] | Which Harbor tasks fit, and whether each one's reference solution passes and its untouched workspace fails, in Docker; no import, no model calls | Works today |
recurz eval run NAME[@v] --baseline LOADOUT --candidate LOADOUT --question Q [--effect 5pp] [--tasks N] [--trials 1|3] [--live MODEL] [--stop-early [--batch N]] [--visibility org|team|private] [--yes] [--json] | PLAN [--yes] | --proposal ID [--held-out | --round-confirm | --confirm EVAL] [--tasks N] [--trials 1|3] [--stop-early] [--yes] | Draft a verdict of one loadout against another (or read a plan file, or test a climb's proposal over its whole pool, by default 3 runs per arm for a selection round or round confirmation and 1 for a held-out check), show the exact quote with tasks and runs per arm, and start it once you say yes; --stop-early looks after each batch of tasks and stops on a clear answer, once the simulator passes the design | Works today |
recurz eval live create NAME@v --runs RUN,… [--min-attempts 2] [--full-every 5] [--yes] [--json] | Save the tasks a model sometimes solves and sometimes misses in those runs as a live-task set, after showing the tally | Works today |
recurz eval live list NAME [--json] | An eval's live-task sets: model, harness, live tasks out of all, and whether a full pass is due or the set is stale | Works today |
recurz eval climb create NAME[@v] --from LOADOUT [--live MODEL] [--rounds 6] [--seed N] [--yes] [--json] | Freeze a split of an eval version into selection and held-out tasks and start a climb from a loadout, after showing the split; spends nothing | Works today |
recurz eval climb list NAME [--json] | Your climbs on an eval: rounds spent, adoptions and status | Works today |
recurz eval climb show ID [--json] | One climb: the split, the incumbent, proposer spend and the rounds table (proposal, mechanism, hypothesis, leak, status, selection result, verdict) | Works today |
recurz eval proposal run --climb ID [--proposer model|scripted|random] [--max-cost USD] [--seed N] [--yes] [--json] | Ask a proposer for the climb's next change; the model proposer (administrators) quotes its cap and asks first, scripted and random are free | Works today |
recurz eval proposal list --climb ID [--json] | A climb's proposals and where each stands | Works today |
recurz eval proposal show ID [--diff] [--json] | One proposal: its hypothesis, cited evidence and leak scan, and with --diff the change itself | Works today |
recurz eval proposal dismiss ID --why TEXT [--json] | Turn a proposal down so it is not proposed again | Works today |
recurz eval simulate NAME[@v] [--model M | --runs RUN,… | --bank reference] [--design pool-one | --tasks all|live|fresh:N --control-runs N --treatment-runs N --pool --keep-rule zero|useful] [--effects 0,10,15,20,-10] [--scope all|live] [--studies 500] [--seed N] [--climb 4|8 [--planted 15]] [--proposer scripted|random [--climb-preset climb-proof] [--rounds 4] [--sabotage 3] [--signal 0.6] [--null-library] [--harm-scale 3] [--round-runs 1|3] [--round-stop-early] [--selection-pool live|full] [--bank-copies N] [--climb-fixture rust|python]] [--stop-early [--batch N]] [--dry-run] [--json] | Size a study design before paying for it: how often it calls a no-op a win, finds a planted gain, holds the true effect in its interval, and what that costs, simulated on recorded outcomes; --stop-early adds what stopping early saves and loses, and --proposer --climb-preset climb-proof simulates the climb setting that recovers a sabotaged setup | Works today |
recurz eval scorecard [NAME@v] [--simulate [--model M]] [--strict] [--json] | Whether the engine works: each check (graders, false wins, detection, coverage, judges, leaks), its latest result and evidence, or what is missing; --strict exits 1 on a fail | Works today |
recurz eval leak-check NAME[@v] --loadout OWNER/NAME[@REV] [--json] | Whether a loadout carries the eval's task material (ids, pull requests, prompts, hidden test names, reference fix), as a verdict's preparation checks it; exits 1 on a block | Works today |
recurz eval compare NAME[@v] [--by category] [--view overall|value] [--limit N] [--json] | Leaderboard of every public loadout on an eval's current version | Works today |
recurz eval plan create NAME@v --bar 1pp --expect 6pp | Size a study before paying for it | Planned |
recurz eval plan show HASH | A frozen plan and its hash | Planned |
recurz eval plan verify RUN | Check a run followed its plan | Planned |
recurz eval task list NAME@v [--candidates] | Tasks, and tasks mined from repo history | Planned |
recurz eval task show TASK | One task | Planned |
recurz eval task create NAME@v --from FINDING | --from-github REPO | A task from an Observerz finding or a repo | Planned |
recurz eval label create NAME@v | Blind hand labelling in the terminal | Planned |
recurz eval label list NAME@v | --set SET | Hand labels | Planned |
recurz eval label export NAME@v -o FILE | Hand labels as JSONL | Planned |
recurz eval label suggest NAME@v [--json] | Failure modes a model suggests from your hand labels, for you to accept, merge or rename | Planned |
recurz eval grader list NAME@v | --set SET | Grader report cards | Planned |
recurz eval scan RUN [--json] | Attempts that may not count, by fixed rules: edits to tests or protected paths, time limits, tool or sandbox errors, giving up | Planned |
recurz bench quote PLAN.json | --verdict ID | --eval NAME[@v] --a LOADOUT --b LOADOUT [--question Q] [--effect 5pp] [--tasks N] [--trials 1|3] [--label-a A] [--label-b B] [--visibility org|team|private] [--json] | Freeze a bench plan (a plan file, a prepared verdict, or two loadouts on an eval) and print its quote: subject, A and B by hash, trials, price (measured by a noise drill or an estimate) and the chance of a clear answer with its give or take; spends nothing | Works today |
recurz bench run PLAN.json | --verdict ID | --eval NAME[@v] --a LOADOUT --b LOADOUT [...] | --plan SHA [--approve USD] [--yes] [--json] | --local PLAN.json --cases FILE [--out DIR] [--approve USD] | Quote a bench run of B against A, ask, then start it; --plan starts a plan quoted earlier and needs --approve; --local runs a command verdict's plan from New verdict on this machine and seals its record, with nothing spent through Recurz | Works today |
recurz bench show ID [--trials] [--record] [--claims] [--json] | One bench run: the verdict with its interval, wins, losses and ties, the quote, spend and events; --trials prints the ledger, --record the sealed record, --claims the four claims it supports with their checks | Works today |
recurz bench list [--subject S] [--state approved|running|sealed|cancelled|failed] [--limit N] [--json] | Bench runs you can read, newest first, with each one's verdict | Works today |
recurz bench subjects [--json] | The model calls Bench can run on jobz (call:<feature>), each with its arms and what serves them, and the models an arm may name | Works today |
recurz bench register FEATURE --arm LABEL=MODEL... [--grader FILE.json] [--per-call USD] [--json] | Register a model call as a bench subject, or add arms to one you registered, with no PR; spends nothing | Works today |
recurz bench grader add FILE.js --id ID --metrics M,... --drill DRILL.json [--version V] [--json] | Upload a grader script for call subjects with the drill it must pass, and print its sha256; spends nothing | Works today |
recurz bench grader show SHA256 [--json] | One grader script: its metrics and its drill's state, with any case it missed | Works today |
recurz bench import DIR|RECORD.json [--ledger FILE] [--visibility org|team|private] [--json] | Hand in a bench record sealed somewhere else (a Squadz study, the kernel's local bench run), after checking it here | Works today |
recurz bench verify DIR|RECORD.json [--ledger FILE] | --run ID [--json] | Check a sealed record offline: re-walk its ledger's hash chain, check the plan, approval and record hashes, and recompute the verdict from the trials | Works today |
recurz verdict list [--eval NAME] [--archived] [--mine] [--limit N] [--json] | Your verdicts and the ones shared with you, newest first; --archived lists the Loadoutz-era runs instead | Works today |
recurz verdict cap [--set USD [--plan SHA]] [--json] | Your org's spend cap per verdict and who set it; owners and admins set it, or raise it for one frozen plan | Works today |
recurz verdict show ID [--tasks] [--flips] [--failures] [--checks] [--looks] [--require kept|no-worse|to-confirm|smaller-than-asked|not-settled|harmful] [--json] | Kept, no worse, to confirm, smaller than asked, not settled or harmful, with the effect's range; --looks shows each look of a verdict that may stop early; --require exits 4 when it isn't | Works today |
recurz verdict compare RUN RUN | Two runs head to head | Planned |
recurz verdict trace RUN TASK | Both arms' traces for one task | Next |
recurz verdict export ID --format html -o FILE | A verdict as one HTML report to read offline | Planned |
recurz verdict live list [--json] | Your org's routing verdicts on live traffic, newest first, with each one's rule and state | Works today |
recurz verdict live preview --model MODEL [--kind KIND] [--try MODEL] [--json] | What a Steerz routing rule would have caught last week, from Steerz's record; no model is called | Works today |
recurz verdict live plan --model MODEL [--kind KIND] --try MODEL --bar POINTS [--title TEXT] [--base-rate SHARE] [--json] | Freeze a routing verdict on live traffic: the rule, the model to try and the bar; nothing is installed or spent | Works today |
recurz verdict live start ID [--json] | Install a frozen routing verdict's rule in Steerz and start the split (owners and admins) | Works today |
recurz verdict live show ID [--rule] [--json] | A live routing verdict: settled sessions per side, the every-look range and the checks | Works today |
recurz verdict live stop ID [--reason TEXT] [--json] | Stop a live routing verdict and remove its rule from Steerz (owners and admins) | Works today |
recurz verdict live propose ID [--json] | After a win, propose the route in Steerz; it stays off until an owner or admin turns it on (owners and admins) | Works today |
recurz experiment list [--json] | Random session split experiments in this repo: draft, running or stopped | Works today |
recurz experiment show ID [--json] | One experiment's arms and outcomes, and how to read its verdict from Tracez | Works today |
recurz experiment check | Check every experiment file the way the session-start hook does | Works today |
recurz experiment run ID | Start a draft experiment: new sessions get an arm once the file is merged | Works today |
recurz experiment stop ID | End a running experiment | Works today |
recurz loadout list [--json] | Your loadouts, each published version with the id a plan names | Works today |
recurz loadout show OWNER/NAME | One loadout: skills, instructions, compatibility | Planned |
recurz loadout diff A B | What differs between two loadouts | Planned |
recurz loadout create --from-agent | Start one from what your agent already uses | Planned |
recurz loadout edit OWNER/NAME | Change a draft loadout | Planned |
recurz loadout release OWNER/NAME | Freeze it so results can point at it | Planned |
recurz loadout export OWNER/NAME -o DIR | Write it to a folder | Planned |
recurz study list | Published, frozen study results | Next |
recurz study show STUDY | One study | Next |
recurz ladder list [--json] | The ladders you can read, each with its champion | Works today |
recurz ladder show LADDER [--holdback] [--json] | A ladder's champion, gain over its start, governor, budget and digest; --holdback reads it against the frozen start | Works today |
recurz ladder create SPEC.json [--share-with-org] [--json] | Open a hosted ladder from a spec; it runs nothing until recurz ladder run approves a weekly amount | Works today |
recurz ladder run LADDER [--per-week USD] [--force] [--yes] [--json] | Step a ladder now, first approving it to spend up to --per-week a week when given (asks unless --yes) | Works today |
recurz ladder pause LADDER --why TEXT | Stop a ladder starting laps; recurz ladder resume starts them again | Works today |
recurz ladder resume LADDER | Let a paused ladder start laps again | Works today |
recurz ladder mirror DIR|JOURNAL [--last TEXT] [--private] [--json] | Show a ladder run on a box on Verdictz: sends its journal as you are signed in, shared with your org unless --private | Works today |
recurz ladder rung list [--ladder LADDER] [--json] | Every subject's champion, or one ladder's rungs, with the verdict behind each, what Watch has seen and its claims | Works today |
recurz ladder rung revoke LADDER --why TEXT [--yes] | Take back a ladder's top rung; the ladder steps down to the one before it | Works today |
Account and org
Machines, members, credits, events, webhooks and settings.
| Command | What it does | Status |
|---|---|---|
recurz org list | Orgs you belong to | Works today |
recurz org use ORG | The default org for later commands | Planned |
recurz org show [ORG] | One org: its region, members and your role | Works today |
recurz org edit [--retention 365d --region] | Change org settings | Planned |
recurz member list | People in the org | Planned |
recurz member invite EMAIL --role | Invite someone | Planned |
recurz member edit MEMBER --role | Change a role | Planned |
recurz member remove MEMBER | Remove someone | Planned |
recurz app list | Installed apps and what data each may read | Next |
recurz app install APP --data sessions:all | Install an app with a data policy | Next |
recurz app uninstall APP | Uninstall an app | Next |
recurz credit list | Credit balance and what spent it | Works today |
recurz credit buy N | Top up (today on recurz.ai/signup/credits/, not through the API) | Planned |
recurz invoice list | One bill across products | Planned |
recurz invoice show INVOICE [--pdf -o FILE] | One invoice | Planned |
recurz story list [--needs-you] [--since] | News stories from the event fabric (what feed and inbox show) | Works today |
recurz story show STORY | One story | Works today |
recurz story dismiss STORY | Take a story out of the feed for everyone | Works today |
recurz story react STORY EMOJI | React to a story | Works today |
recurz event list [--type tracez.session.*] [--since 24h] [-f] | The raw per-org event log; -f keeps printing new events as the API pushes them | Works today |
recurz event show EVENT | One event | Planned |
recurz webhook list | Endpoints that receive events | Works today |
recurz webhook show WEBHOOK | One endpoint, and why it is failing or off | Works today |
recurz webhook create URL --events [--description] | A new webhook; prints its signing secret once | Works today |
recurz webhook edit WEBHOOK [--url] [--events] [--description] [--enable|--disable] | Change a webhook | Works today |
recurz webhook delete WEBHOOK [--yes] | Delete a webhook (asks first) | Works today |
recurz webhook test WEBHOOK | Send a test delivery | Works today |
recurz webhook replay WEBHOOK [--after SEQ] [--limit] | Deliver the org's events again | Works today |
recurz webhook rotate WEBHOOK [--yes] | Replace its signing secret (asks first) | Works today |
recurz webhook deliveries WEBHOOK [--limit] | Its delivery log, newest first | Works today |
recurz audit list [-f] | Every admin change | Planned |
recurz run list [--running] [--product] | Every long job on every product | Planned |
recurz run show RUN | One job | Planned |
recurz run watch RUN | Follow a job until it ends | Planned |
recurz run cancel RUN | Cancel a job | Planned |
recurz share create ID [--turns 40..45] | A read-only, redaction-aware link | Planned |
recurz share list | Links you shared | Planned |
recurz share revoke SHARE | End a link | Planned |
recurz config list | Local settings | Planned |
recurz config get KEY | One local setting | Planned |
recurz config set KEY VALUE | Change a local setting | Planned |
recurz config unset KEY | Clear a local setting | Planned |
recurz completion bash|zsh|fish | Shell completion | Planned |
recurz update | Install the newest recurz | Planned |
recurz mcp [--all] [--channel [TYPES]] | Recurz's MCP tools over stdio with this sign-in, for harnesses that start MCP servers as a command (the agent profile; --all for every product's tools; --channel pushes each new org event into a Claude Code session) | Works today |
recurz statusline [--shell] | A statusline or prompt segment: cost, cache, route, inbox | Planned |
recurz api TOOL [JSON] | Any Recurz API tool's raw JSON | Works today |
Works today In the recurz binary now. Next The service does it today; the command is being wired up. Planned Designed, not built yet. Run recurz help for the commands in your version.