Install RepoOps

RepoOps is a desktop app + a localhost dashboard. The installer puts a tiny Electron shell on your machine that supervises a Node server (port 4000 by default) and opens the dashboard at http://localhost:4000 in a window. Your data — telemetry, brain files, account mappings — lives in your home directory, never on our servers.

What you get out of the box:the Today cockpit, telemetry across every repo you track, the activity ledger, the app-LLM-calls rollup, security guardrails, the env doctor, and every brain twin from each tracked repo's .claude/brain/.

• Windows 10 / 11. 64-bit. Roughly 250 MB of disk for the install + data dir.
• Git on your PATH. Open a terminal and run git --version. If it doesn't resolve, install Git first (git-scm.com).
• Optional but recommended: gh CLI (GitHub CLI). The dashboard's "Propose routing PR" flow uses it. Skip if you don't need that surface yet.

1. Download the installer

   Download for Windows →from the homepage. You'll getRepoOps-Setup.exe (~120 MB).

   ⚠

   SmartScreen prompt is expected (for now)

   The installer is currently unsigned. Windows SmartScreen will say "Microsoft Defender SmartScreen prevented an unrecognized app from starting." Click More info → Run anyway. Signed builds land before the public release.

2. Run the installer

   Double-click RepoOps-Setup.exe. The first-run wizard creates a desktop shortcut and opens the dashboard automatically when it's done. ~30 seconds.

3. Add your first repo

   On the first-run wizard, click Pick first repo and select a directory that has a.git folder. RepoOps spins up a mirror worktree pinned toorigin/mainand starts aggregating that repo's.claude/brain/.

4. Bootstrap a brain (if the repo doesn't have one yet)

   The aggregator works on day one for security guardrails, env doctor, vulnerabilities, and settings — even with no .claude/brain/. To unlock the brain-powered tabs (Sessions, Decisions, Errors, Lessons, Brain reflection, Link graph), open Repo bootstrap in the dashboard sidebar (Manage → Help → Repo bootstrap), copy the prompt, and paste it into Claude Code, Cursor, or Codex pointed at your repo. The LLM creates .claude/brain/, CLAUDE.md, the skills, and the CI gates. Refresh the dashboard — the brain tabs light up.

   ⓘ

   So the real flow is: install + bootstrap

   Install takes ~30 seconds. The bootstrap paste takes a couple of minutes for the LLM to write the files. Plan for 2–3 minutes end-to-end on a fresh repo. If your repo already has a brain (you used RepoOps elsewhere, or you ran bootstrap before), skip this step.

5. Open the dashboard

   The app opens http://localhost:4000 in its window. You should see the sidebar on the left with your repo as the active Repo in the switcher at top, and the Today cockpit as the main pane. Press ⌘ K (or Ctrl K on Windows) to open the command palette — confirm you can fuzzy-search to a tab.

You can run the dashboard fine with defaults. These are the knobs worth knowing:

• BYOK Anthropic key. Open Settings → BYOK. Paste an API key (kept in a data-dir .env, never in git). Unlocks AI-assisted explainers + the "Analyze with Claude" buttons.
• Clients / accounts. Add accounts under Settings → Accounts when you start tracking work for multiple clients. Settings docs.
• Telemetry privacy. Default is metadata-only (no prompt content captured). Switch to content-redacted mode under Settings → Telemetry privacy if you want it. More.
• Auto-update. On by default. Toggle from Settings → App updates, or set the env var REPOOPS_AUTO_UPDATE=0 for hard-off. Update docs.

1. Open the dashboard window. The header status row says main @ <sha> with a green dot when the mirror is fresh.
2. Switch repos via the top-of-sidebar switcher. The repo list narrows when you pick a Client.
3. Press ⌘ K, type today — Today tab opens.
4. Press g then r — Roadmap tab opens. (You're wired up.)

• Port 4000 in use. The installer auto-picks a free port — check the window's URL bar for the actual port. Or set REPOOPS_PORT=4010.
• Mirror says "error". Open the terminal log (the installer logs it to %LOCALAPPDATA%\RepoOps\server.log) and look for the git fetch error. Usually a missing remote / auth.
• Dashboard window is blank. The Electron shell occasionally races the server boot. Wait 5 seconds and refresh (Ctrl R).

One install gives you what most teams cobble together from five tools: live cost telemetry, a brain that survives session resets, vulnerability + footgun scans, a paper trail of who touched what. All on your machine — your data never leaves it.

Open Today— it's the home tab and the fastest way to see what the cockpit can do. Then Settings to add more repos or configure your BYOK key.