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. Telemetry, brain files, and account mappings live in your home directory by default. Data reaches RepoOps' hosted service only after you bind the device and enable the relevant sync; the anonymous reliability beacon is the documented default-on exception and can be disabled in the app.

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), macOS, or Linux. 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 device and 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. The npx repoops bootstrapper installs the Windows build; on macOS or Linux it points you at the download page for the .dmg, AppImage, or .deb.

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 to build your app and optionally enrich repository knowledge; deterministic brain setup needs no model call.

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 Signatures before 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 Choose folder and select a directory that has a.git folder. RepoOps spins up a mirror worktree pinned toorigin/main and starts aggregating that repo's.claude/brain/.

4. Review repository setup

   Review the exact changes in first-run setup, then apply the deterministic integration. It creates a minimal .claude/brain/ and merges managed sections into CLAUDE.md and AGENTS.md. Existing instructions are preserved. For an existing install, use Settings.

   ⓘ

   Verify the evidence separately

   A successful file write does not prove assistant capture or team delivery. Follow the repository integration guide to check each connection.

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.

1. Download the right build for your Mac

   Download for macOS → from the homepage. Pick the Apple Silicon (arm64) .dmg on an M-series Mac, or the Intel (x64) .dmg on an Intel Mac. Not sure which you have? Open About This Mac and read the chip line.

2. Open the .dmg and launch the app

   Open the .dmg and drag RepoOps into Applications.

   ⓘ

   First launch needs right-click then Open

   The macOS builds are not notarized yet, so a plain double-click on the first launch is blocked. Right-click the app and choose Open, then confirm once. If macOS still refuses, open System Settings → Privacy and Security and click Open Anyway. After the first launch it opens like any other app.

3. Add your first repo and open the dashboard

   On the first-run wizard, click Choose folder and select a directory that has a.git folder. The app opens http://localhost:4000 in its window with the Today dashboard. If the repo has no brain yet, follow the reviewed repository setup step from the Windows guide above (it is identical on every platform).

RepoOps ships for Linux as an AppImage and a .deb package. Use whichever fits your distro.

1. Download the AppImage or .deb

   Download for Linux → from the homepage. Grab the.AppImage for a portable single file, or the .deb on Debian or Ubuntu.

2. Make it runnable and launch it

   AppImage: mark it executable and run it.

   • chmod +x RepoOps.AppImage
   • ./RepoOps.AppImage

   .deb: install it with your package manager.

   • sudo dpkg -i RepoOps.deb
   • or sudo apt install ./RepoOps.deb (pulls any missing dependencies)

3. Add your first repo and open the dashboard

   On the first-run wizard, click Choose folder and select a directory that has a.git folder. The app opens http://localhost:4000 in its window with the Today dashboard. Review repository setup as on Windows above.

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.
• 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. The local experience stays on your machine by default; hosted sharing begins only when you bind the device and enable the relevant sync.

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.