Reference · CLI reference
CLI reference
27 commands, and this page is generated from the registry the binary reads. Install the app, then type repoops <command> in any terminal. A check in CI fails the build when a command is added without an entry here, so the list below is the list that ships.
Before anything else
Every command below runs out of your installed RepoOps app. The repoops package on npm is the front door: it locates that install and hands your arguments straight to it. So install the app first (Install), then either npm i -g repoops once and type repoops <command>, or reach it through npx with no install of its own:
repoops help # the same list as this page
npx repoops doctor # or go through npx, same commandsinit and run ask for a one-time sign-in, which opens repoops.ai in your browser to register and authenticate. It is free for solo developers, your code and telemetry stay on your machine, and the token is cached so everything works offline afterward. In CI or Docker, set REPOOPS_AUTH_TOKEN and no browser is needed. Anything marked local only below never talks to a server at all.
Setup
Install a brain, track a repo, start the dashboard, bind to a team.
run
Boots the dashboard and opens the sign-in gate, then serves http://localhost:4000. This is the command the desktop app runs for you; type it when you want the server in a terminal you control.
repoops runStart the dashboard (sign-in gate + http://localhost:4000)
init
Writes a .claude/brain/ into a repo that has none. The scaffolder reads the same canonical tab registry the dashboard renders from, so a fresh brain matches what the dashboard expects. Hand the generated brain-bootstrap-prompt.md to your coding agent to fill the stubs with real content.
repoops init [dir]Scaffold a .claude/brain/ into a repo (default: current dir)
add
Registers a repo with the dashboard so its brain, docs, and telemetry appear alongside everything else you track.
repoops add [path]Track a repo in the dashboard (default: current dir)
remove
also: repoops rmStops tracking a repo. It leaves the repo and its brain on disk; only the dashboard's registration goes away.
repoops remove <id|path>Stop tracking a repo
doctor
Checks a repo's brain and its wiring into the dashboard, and names what is missing. Run it when a tab is empty and you cannot tell whether the fault is the repo or the server.
repoops doctor [dir]Check a repo's brain + dashboard wiring
connect
Binds this install to a team using a one-time code from /team/connect. Until you run it, the install is a solo one and nothing leaves the machine.
repoops connect <code>Bind this install to a team with a one-time connect code (from /team/connect)
Attribution
Which session, prompt, or agent produced a line, and what that measures out to.
blame
Answers who wrote a line, where the answer includes the agent. Given a file it reports the session and prompt behind each line; given a commit it reports the agent and human split.
repoops blame <file>Which session/prompt wrote a line, or a commit's agent/human split
bench
Runs the accountability metrics against this repo and prints the real numbers, not a sample. It reads local evidence only, so the figures are yours and nothing is uploaded. The published figures on /accountability-benchmark come from this command run against RepoOps itself.
repoops benchRun the real accountability metrics against this repo (local only)
import
Reads a Git AI refs/notes/ai note and maps it into a RepoOps proposal, so attribution captured by another tool lands in the same ledger. Only the git-ai source is wired.
repoops import git-ai --dry-runMap a Git AI refs/notes/ai note into a RepoOps proposal (local only)
Memory and skills
Hold agent memory and agent capabilities to a signed, sanctioned state, and rewind the tree when one goes wrong.
memory
Agent memory is an input to every run, which makes it worth poisoning. Sign records the state you sanctioned; verify checks the current .claude/ brain and CLAUDE.md against those signatures and flags what changed without your say-so.
repoops memory verifyVerify agent memory (.claude/ brain + CLAUDE.md) against its sanctioned signatures; flags poisoning candidates (local only)
repoops memory signRecord the sanctioned state of agent memory (local only)
skills
The same signed-state check, applied to what your skills and subagents are allowed to do. Sign records each capability manifest; verify reports drift from it.
repoops skills verifyVerify each skill / subagent against its signed capability manifest; flags drift (local only)
repoops skills signRecord the sanctioned capability manifests of your skills + subagents (local only)
checkpoint
Snapshot and restore the working tree without a commit and without moving HEAD. Use it before letting an agent make a large change, so undoing it costs one command rather than a rebase.
repoops checkpoint <cmd>Snapshot, list, or restore a working-tree checkpoint (create|list|restore)
Security
What the agent can reach, what it is allowed to reach, and how it behaves when something tries to steer it.
nhi
Inventories the long-lived secrets a non-human identity on this machine can read, and reports which are over-exposed for what the agent actually does. Discovery only: it reads, it does not rotate.
repoops nhiInventory the long-lived secrets your agent can see, with an over-exposure report (local only)
broker
A loopback-only credential broker, so the agent holds a short-lived task-scoped token instead of your raw key. Opt in and it mints on demand; leave it off and nothing listens.
repoops brokerLocal credential broker: status, or mint a short-lived task-scoped token so the agent never holds the raw key (opt-in, loopback-only)
readiness
One day-one score out of 100 from local discovery plus the advisory detectors, with the top five fixes named. The starting point when you want to know where a repo stands before picking a specific scan.
repoops readinessDay-one security readiness score (0-100) + top-5 fixes from local discovery + advisory detectors (local only)
injection-eval
Scores this repo's resistance to prompt injection by running a probe corpus against your agent configuration, and treats the score as an eval bar: it exits non-zero when the repo does not clear it, so CI can hold the line.
repoops injection-evalScore this repo's injection resistance (probe corpus vs agent config) as an eval bar; exits 1 when it does not clear (local only)
egress-policy
Shows or edits the pinned domains and IPs a repo's sandbox may reach. An agent that cannot resolve an unexpected host cannot quietly exfiltrate to one.
repoops egress-policyShow or set a repo's sandbox egress allowlist (pinned domains/IPs); add/remove <host> (local only)
mcp-scan
Reads the MCP servers you have configured and reports definition drift, the tool-poisoning case where a server's tool description changes under you after you approved it.
repoops mcp-scanScan configured MCP servers for tool-poisoning definition drift (local only)
mcp-allow
Pins the MCP servers you approve and lists what mcp-scan has flagged against those pins.
repoops mcp-allowPin the MCP servers you approve; list what is flagged (local only)
redteam-mcp
Attacks your own MCP setup with a library of tool-poisoning attacks and reports which ones land. Where mcp-scan watches for drift, this one goes looking.
repoops redteam-mcpRed team your own MCP setup against a tool-poisoning attack library (local only)
Attestation
Verify an AI-authorship record with no server and no account.
verify
Checks an AI-authorship attestation offline: no server, no network, no account. A tampered or unknown record fails honestly, and the verdict is the same one the dashboard page gives. --key is the install's public verification material, never a private signing key.
repoops verify <record>Verify an attestation OFFLINE (no server, no network)
conform
Grades a third-party emitter's attestation against the v0.2 conformance suite, check by check (graded band, honest-null cost, digest, signature). --key is optional; without it the signature check is skipped rather than faked.
repoops conform <record>Check an attestation against the v0.2 conformance suite
go-live
Reports the Wave B public-claims preconditions and which of them this install currently meets.
repoops go-liveReport the Wave B public-claims preconditions (CNA.31)
Capture and fleet
Get session evidence off a machine and into the dashboard, on one install or across a fleet.
sensor
The capture pass on a bound install: read new session evidence, buffer it, push it. Run it once, or run it as a daemon that repeats on an interval. With --otlp-receive the daemon also hosts a loopback OTLP/HTTP receiver, so OTLP-emitting tools can push into a bare Sensor with no other agent installed.
repoops sensor --oncePassive capture + buffered push on a bound install (--enroll <secret> for headless fleet)
repoops sensor --watchLong-running daemon: repeat the capture+push pass every --interval <sec> (default 60)
repoops sensor --watch --otlp-receiveAlso host a localhost OTLP/HTTP receiver (127.0.0.1, --otlp-port <n>, default 4318) so OTLP tools push into a bare Sensor
tap
An optional in-path tee for capture. The Sensor is the supported default and this is an unsupported beta; reach for it only when a passive pass genuinely cannot see what you need.
repoops tap --helpThe optional in-path tee (UNSUPPORTED BETA; the Sensor is the default capture)
enroll-secret
Mints the enrollment secret a headless install passes to `sensor --enroll`, so a fleet machine can bind with no browser. Owner or admin only.
repoops enroll-secret mintMint a fleet enrollment secret (owner/admin; for headless sensor --enroll)
Engagements
Scaffold the deliverables of a forward-deployed engagement.
fde
Scaffolds one of the named forward-deployed engagement deliverables. The mcp kind takes --connector, --auth, and --no-eval; the others take the name alone.
repoops fde new <kind> <name>Scaffold an FDE deliverable (mcp|subagent|skill|auth|eval); mcp takes --connector, --auth, --no-eval
What this page will not tell you
Each command carries its own flags, and this page lists the ones worth knowing before you type it rather than all of them. Run a command with --help for its full set: the front door forwards the flag to the app rather than answering it itself, so repoops mcp-scan --help gets you the scanner’s help and not this list again.
For what the numbers from repoops bench mean, see the accountability benchmark. For what the security commands are defending against, see AI security.
Last updated