Docs

Documentation

Connect your repository and developer stack, verify collection and team delivery, then investigate the whole incident. Attribution, AI Security, Remediation, LLM Cost Metrics and Memory share one evidence trail.

Getting started

Get RepoOps running on your machine in under five minutes.

Start with one thing

Start with one of the five product areas. Each of these is the shortest real path to a first result.

Today

Where am I, what is here, find anything fast. The daily orient surface.

My Brain reference

The person-scope brain you own, on its own page.

Guide + video
Today

Know what to do next. Spend, ship-readiness, vulnerabilities, brain pulse: the one tab to open each morning.

Guide + video
Combined remediation

Pick several things off your queue and get one ordered plan: grouped by what a change touches, foundations first, and the human-gated work in its own pull request.

Read guide
Approval queue

The Today queue when the machine builds the fixes: three bands, an editable build floor and daily cap, and one approve-or-reject decision per finished, verified pull request.

Guide + video
Notifications

Triage-first alerts ranked by blast radius. Capped, quiet, and suppressed when a lesson already covers it.

Guide + video
First run

One screen of questions, then RepoOps configures itself and verifies every step.

Guide + video
File search

Universal cross-repo file index. Substring search across paths and titles.

Guide + video
Actions queue

The queued and running actions across your repos, with status and one-click open.

Guide + video
Workflow runs

Every multi-step workflow run, its slices, and where each one landed.

Guide + video
Team home

The /team landing: connected devices, invites, budget alerts, server-owned policy.

Guide + video
Hosted dashboard

The hosted /dashboard view: what stays in the cloud, what stays on each laptop.

Guide + video
Standup over MCP

Bring your own agent: the recipe for a morning team standup prompted over the RepoOps MCP server.

Read guide
Session briefing

Your standing situation report. One signal hub for spend, ship-readiness, the queue, and what your next session will load.

Guide + video

Watch

Watch every run, session by session: traces, transcripts, and the record of what shipped.

Forensics

Reconstruct what an agent received, did, proved, and learned, without turning missing evidence into a conclusion.

Guard

Guard the loop. Trust boundaries, footgun scans, and what will not ship broken.

Inbound triage

Incoming items to triage before they reach the review queue.

Read guide
Rules

The anti-pattern rule engine: list, tune, test, and author rules with no code file.

Read guide
Security

Know it will not ship broken. Trust boundaries, BYOK, threat model, plus a live footgun scan.

Guide + video
MCP security

Review MCP server trust, permissions, and tool exposure before an agent can cross the boundary.

Read guide
AI incident response

Turn a security detection into a case somebody works: a lifecycle, a clock your team sets, a playbook over the containment verbs that already ship, and a guard that stops the next one. Evidence never leaves the machine that observed it.

Guide + video
Auto-remediation

Scope a finding into a brief, build the fix as a pull request in your own checkout, verify it five ways, and decide on the evidence. A failed check stays visible with its reason. Auto-remediation is off until you turn it on: with it off, nothing merges without you.

Guide + video
Fleet remediation

The loop across every repo you track: one approval queue with the repo named on every item, one floor and one daily cap with per-repo narrowing, and a fix that is built, verified and merged in the repo it belongs to. What each repo can and cannot do is stated before anything runs.

Guide + video
Incidents ledger

The hosted Incidents tab lists every prevented incident from your team event store, with the guarding-action verb and the dollars it saved.

Read guide
Permissions

What each agent and tool is allowed to touch, and where the boundaries sit.

Guide + video
Blast radius

The reach of a change before you ship it: what it touches, what it could break.

Read guide
Scope contracts

The declared read and write scope for each surface, enforced at the boundary.

Read guide
Pre-PR preflight

Runs the same checks CI would, in about 90 seconds, before the PR opens.

Guide + video
Diff review

Review a diff line by line: brain decision rules, security checks, and blast radius on the changed hunks.

Guide + video
Env config

Env-var registry: which file reads what, plus the Doctor's plain-language footgun checks.

Guide + video
Incidents

Production alerts auto-correlated to the change and the AI session that likely caused them.

Guide + video
Guard + Manage

The hosted Guard and Manage controls for the team.

Guide + video
Review queue

The shared team queue of code changes and PRs awaiting human review, with reviewer and status per item.

Read guide
Security Tax

Four report-only checks that price what running loops unattended costs you. A check with no signal reads unknown, never a fabricated pass.

Guide + video
Agent Code Security

The team rollup of three local scans over what your agents write: the agent's own diff, hallucinated dependencies, and secrets caught at write time.

Guide + video

Prove

Prove what happened. Outcomes, loop economics, and the accountability ledger.

Spend

Use more AI, spend less. The aggregated economic view.

LLM Cost Metrics

The cost case queue, each case's Cost section with billed and measured kept apart, and what the page does not total.

Guide + video
Routing savings receipts

A measured before and after receipt per adopted routing proposal. Not yet measured until the window fills; never a projection.

Read guide
Billing Guard reference

Reconcile your Claude bill against locally captured token counts.

Guide + video
Telemetry

Know what it cost. Combined-mode Claude Code telemetry across every tracked repo.

Guide + video
Claude Code usage

Per-session token spend with heuristic and LLM-driven recommendations on where to save.

Guide + video
Subscription seats

What a wall of AI subscription seats is producing. A seat with nothing captured reads no activity captured, never unused, and carries what would settle it.

Guide + video
Spend efficiency

A composite Spend-Efficiency grade over six levers: defaults, routing, caching, context, visibility, ROI.

Guide + video
Billing Guard setup

Telemetry-vs-invoice reconciliation: expected cost recomputed from your own telemetry, joined against Anthropic's usage and cost reports, findings with an evidence bundle finance can dispute with.

Guide + video
Billing Guard CLI

A zero-model-token audit that reconciles local Claude Code telemetry against the Anthropic Admin Usage & Cost API and writes an evidence bundle for finance.

Read guide
Billing Guard for Claude Desktop

The same audit as an .mcpb extension inside Claude Desktop: per-user install for managed laptops, Admin key in the OS keychain, optional background sweep.

Read guide
CI spend

What your build pipeline costs, by workflow, by job, and per merged PR. Minutes are measured from each job's own timestamps and rounded up per job the way GitHub bills, then priced from a published rate table, because GitHub exposes no cost API to read for a user-owned account; the page says so above the number rather than in a footnote.

Guide + video
Provider spend

One unified cross-provider view of real metered LLM spend from two lenses that are never summed: provider-reported (authoritative, org-wide) and locally-captured (attributed to this install), each line carrying a per-token, day-level, or per-call precision band, with unconnected providers shown as not connected rather than $0.

Guide + video
Team activity

Cross-developer activity ledger with integrity proofs. Per-binding drill-down.

Guide + video
Costs (hosted)

Team vendor spend and budget alerts.

Guide + video
Today / Watch / Spend

The hosted Today, Watch, and Spend rollups in one place.

Guide + video

Brain

A brain that never resets. What your AI learned, the decisions behind the code, the patterns worth keeping.

Memory

Review a lesson from its case, see where each version went, and read recurrence as a numerator over a denominator.

Guide + video
Knowledge graph explorer

Explore the knowledge graph of brain files, code, and concepts.

Read guide
Creator packs

Publish a slice of your brain as a pack other people can install: pick the memories one by one, read the redaction diff before anything leaves, and bring a published pack up to date without silently shipping what you wrote since.

Read guide
Brain reflection

Last night's lesson proposals: review, accept, reject. The reason your second project goes faster.

Guide + video
Ask the brain

Ask your brain a question in plain language and get an answer grounded in your own notes.

Guide + video
Ask with your own key

The Telemetry mode of Ask the brain: metric questions answer free, anything else runs a bounded tool loop over your telemetry on your own Anthropic key.

Read guide
Team brain

One read surface over what the team knows, what it learned this week, what it prevented, and who is working on what.

Guide + video
Lessons

The active lesson store. Every accepted lesson regenerates into CLAUDE.md and AGENTS.md on next run.

Guide + video
Recurrence rules

Anything you did twice becomes a proposed prevention rule you accept, reject, or snooze.

Read guide
Decisions

The ADR log: every architectural call with the reasoning. The receipts behind the code.

Guide + video
Errors

The error-learning loop: what broke, what fixed it, what rule prevents it next time.

Guide + video
Brain health

The freshness and coverage of your brain: what is decaying, what is missing.

Guide + video
Knowledge Graph

A hosted view over your team's persisted graph store, showing node counts by type, edge counts by source, and confidence bands from a distilled, redacted snapshot the desktop streams on its hourly brain cycle.

Read guide
Auto-memory

The memory that captures itself as you work, no manual note-taking required.

Guide + video
Relationship graph

Force-directed graph of brain cross-references. Node size scales with influence.

Guide + video
Session drafts

Draft end-of-session entries generated from the work, ready to review and keep.

Guide + video
Patterns library

Cross-repo pattern library: what is shared across 2 or more repos, what is worth promoting.

Guide + video
Team brain metrics

The brain pulse rolled up across every connected developer.

Guide + video
Brain read surfaces

The hosted brain read surfaces and what each one exposes.

Guide + video
Your model key

Hosted Ask runs on your own Anthropic, OpenAI or OpenRouter key. Where to add it and what happens without one.

Read guide
Quality + Score

The team quality score and how it is computed.

Guide + video
Coach rollups

Coaching signals rolled up across the team.

Guide + video
Brain health (hosted)

Brain freshness and coverage across the team.

Guide + video
Open in Obsidian

Your brain is already a valid Obsidian vault. Point Obsidian at it, install Dataview, get a graph view plus live dashboards. Edits flow back through the write-trust guard.

Planned
Integrate your brain anywhere

Mint a scoped, revocable read token and read a slice of your brain from any external property. Copy-paste REST and JS snippets plus a Google Sheets Apps Script template.

Read guide
Wiki

An auto-generated descriptive wiki over your repo source.

Guide + video

Manage

Administer the dashboard, onboard new repos, install the brain elsewhere.

Cloud audit log

The hosted audit log across your team.

Read guide
Onboarding

The hosted first-run checklist: connect, publish, confirm telemetry.

Read guide
Settings

Add or remove tracked repos at runtime. Manage clients, accounts, BYOK keys, telemetry privacy.

Guide + video
Controls

Arm or disarm the advisory controls RepoOps can apply, per repository.

Guide + video
Request intake

Ask for a change from the dashboard: submit a feature, fix, or cleanup, triage it in Manage, and let the request builder open one human-gated PR per queued request.

Guide + video
Audit log

Every privileged action, who did it, and when. The tamper-evident record.

Guide + video
Data requests

Answer a request to read one session's transcript, exclude cycles before you answer, and revoke a grant you gave.

Guide + video
Granted transcript

The owner's end of a grant: read the one session a developer granted, see what they withheld, and leave the read on the audit log.

Read guide
Governance

The local-first cryptographic governance surface: ledger verification, redaction posture, policy, file integrity.

Guide + video
Memory setup prompt

The portable brain plus skills plus docs prompt. Port this setup to any repo in one paste.

Guide + video
Repo setup prompt

The full gold-standard repo setup prompt: every convention this project has earned.

Guide + video
Dashboard quickstart

Run the local dashboard and read a repo's brain files in it.

Guide + video
Admin (hosted)

The hosted admin surface: members, roles, org policy.

Guide + video
Audit log (hosted)

The hosted, tamper-evident audit log for the team.

Guide + video
Governance (hosted)

Team governance: policy, controls, and enforcement.

Guide + video
Share (hosted)

Team share links and their scopes.

Guide + video
Billing & license

How team licenses work, how billing rolls up, what happens if a license lapses.

Guide + video
Account

Account settings: invites, role management, the linking-code flow for bound devices.

Guide + video
Launch readiness

A one-shot launch-readiness audit prompt you can run against any repo.

Read guide

Workspace tools

Guides for the utilities outside the six sections: connecting sources, installing, recovering the local app and fixing a failed connection.

Reference

How the system is built, and the direction it is headed. The durable reference docs.

Reference index

One searchable index over every brain and docs reference for this repo.

Read guide
BYOK embeddings

Bring your own embedding key: how vector indexing uses it and the fallback when it is missing.

Read guide
Outbound email compliance

How outbound email meets compliance: unsubscribe, sender identity, and rate rules.

Read guide
Become a proof partner

The Partner Proof Spec v1 for vendors: emit your enforcement decisions as NDJSON and they land in the accountability ledger as tamper-evident receipts.

Guide + video
Tab reference

A flat index of every dashboard tab and the doc that covers it.

Read guide
API reference

Every HTTP endpoint the local dashboard and the hosted app serve, with its shape and what reads it.

Read guide
CLI reference

Every repoops command, grouped, with the invocation you type. Generated from the same registry the binary reads, so the page and the CLI cannot disagree.

Read guide
Reference (hosted)

The hosted reference index for the team scope.

Guide + video
Supported adapters and capture

Which sources each app reads, in which role, which families they observe, and which reads are blocked and on what.

Read guide
Privacy and retention

What leaves a developer's machine, what a transcript grant covers, what redaction does before storage, and who can delete a team's rows.

Read guide
No data is not no incidents

How each home tells a source that observed nothing from a source that observed zero, and why a quiet window never reads as protection.

Read guide
Review a lesson and roll out a prevention package

From a verified incident to a package a second person reviews, a pilot that warns before it blocks, and receipts that say what reached a session.

Read guide
Verified recovery

The eight checks a remedy passes before a case is resolved, the exact-scope approval that lets a fix apply, and what a cost receipt may and may not say.

Read guide
The incident case

One case, its identity, the seven sections in one order, the seven statuses and the moves between them, and who may make each move.

Guide + video
Cost receipts and approvals

The three receipt kinds, the four bases, shares of a shared bill, estimates with their method, what unknown means, and the exact-scope approval.

Guide + video
Lessons and recurrence

How a lesson is admitted, the five delivery receipts and six guard outcomes, and how a recurrence is decided against the versioned signature.

Guide + video
The local companion

The same case on the desktop app, what it pushes and pulls, how a team decision comes back, what stale means, and what the app keeps offline.

Guide + video
Feature stories

Every narrated 30-second feature story with captions and a transcript, one per canonical feature, labeled synthetic, each linking to its guide.

Guide + video
One incident across the six homes

A labeled synthetic walkthrough from Today to the next session: understand the change, verify the remedy, improve the next session, with the missing link named.

Read guide

Common questions

Do I need an account to use RepoOps?

No account to run the app. The free desktop app runs locally and your code and telemetry stay on your machine. We ask for your email before we show you the download link, and we mail you a one-time link to it. An account is only needed for the paid hosted, team, and enterprise tiers.

How do I install RepoOps?

Download the desktop app for Windows, macOS, or Linux from the download page, or install it from the terminal with npx repoops. It signs you in first. On Windows it then downloads the signed installer, verifies its hash and launches it. On macOS and Linux it opens your build in the browser: those are early, unsigned builds, so your OS asks you to confirm the first launch.

Is there a walkthrough for each feature?

Every surface in the dashboard has a focused doc page, organized around Attribution, AI Security, Remediation, LLM Cost Metrics and Memory, with setup and team administration alongside them. About half of those pages also carry a 30-second video walkthrough, and the docs index shows which guides include video. New walkthroughs ship every release.

Maintenance evidence

Supported product version
RepoOps v0.3.2
Last verified
2026-09-26, read against origin/main at e5bb5297b; the index renders DOCS_SPINE and takes its video chips from lib/docs-video-index
Example fixtures
None. The page renders DOCS_SPINE and the published video index; it reads no workspace data.
Video review
No video by design. The index lists guides; each guide carries its own walkthrough where one exists.

Read the RepoOps blog

Last updated