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 dashboard, 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.

Prefer the terminal? One command does the whole install - the repoops npm package is a thin bootstrapper that installs the desktop app:

• npx repoops - signs you in, then downloads and launches the Windows installer.

It opens your browser for the one-time, free sign-in (Google, Apple, or an emailed sign-in link - every path verifies your email address). Click Approve this deviceand you land back on this guide while the terminal keeps going on its own: it fetches the latest signed installer from this site, shows a progress bar, verifies the download's hash against what the site published, and starts RepoOps-Setup.exe. From there it is the same ~30-second wizard as the download-button path above.

The demo runs from the app: once installed, open RepoOps and take the tour from the Home screen - sample data, fully offline, your real data untouched. On macOS or Linux, npx repoops says so honestly (Windows is shipping today; macOS and Linux are next) and points at the download page.

What else the npm path needs installed:

• Node 20+ - runs the bootstrapper (the installed app bundles its own runtime).
• Git on your PATH - same requirement as the desktop app.
• Optional: gh CLI - only for the "Propose routing PR" flow.
• Optional: your coding agent (Claude Code, Cursor, or Codex) - used once per repo at bootstrap to write the brain files.

1. Download the installer

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

   ⓘ

   The installer is signed

   It is code-signed and timestamped by PromptReports LLC, so you can confirm the publisher under Properties → Digital Signaturesbefore running it. The certificate is new, so SmartScreen may still note the app "isn't commonly downloaded yet." If you see that, click More info → Run anyway. It fades as install volume builds.

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 to 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 dashboard 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 PORT=4010.
• Mirror says "error". Open the terminal log (the installer logs it to %APPDATA%\repo-dashboard\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 dashboard can do. Then Settings to add more repos or configure your BYOK key.