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 commands

init 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 run

Start 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 rm

Stops 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 bench

Run 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-run

Map 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 verify

Verify agent memory (.claude/ brain + CLAUDE.md) against its sanctioned signatures; flags poisoning candidates (local only)

repoops memory sign

Record 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 verify

Verify each skill / subagent against its signed capability manifest; flags drift (local only)

repoops skills sign

Record 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 nhi

Inventory 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 broker

Local 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 readiness

Day-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-eval

Score 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-policy

Show 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-scan

Scan 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-allow

Pin 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-mcp

Red 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-live

Report 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 --once

Passive capture + buffered push on a bound install (--enroll <secret> for headless fleet)

repoops sensor --watch

Long-running daemon: repeat the capture+push pass every --interval <sec> (default 60)

repoops sensor --watch --otlp-receive

Also 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 --help

The 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 mint

Mint 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