Tab · Manage

Settings

Everything you wire once and forget. Add or remove tracked repos at runtime, manage clients and accounts, paste your BYOK Anthropic key, control telemetry privacy, and connect this desktop to a hosted team — without restarting the dashboard.

See it in motion

Where to find it

  • Localhost: http://localhost:4000/settings.html
  • Hosted: Account settings at repoops.ai/account (invites, role management, linking codes).
  • Keyboard: ⌘ K then settings, or g , jumps direct.
  • Sidebar: Manage → Settings (first item).

What it does for you

You'll never edit repos.config.json again.Add, remove, and reassign tracked repos at runtime. No server restart, no JSON editing, no lost telemetry.
Your BYOK key stays on your machine.Paste your Anthropic key once; it's written to an update-safe per-user data dir, never to the install tree. Masked-only, never displayed in clear.
One desktop, many clients.Group tracked repos under client accounts for per-client billing rollups, color tags, and invoice export. The agency view, baked in.

Configure

Settings IS the configure surface — but a few things live in env vars by design (initial bring-up, headless environments).

  • repos.config.json — the canonical store. Settings UI edits this file safely; you can also hand-edit when bringing up a new machine.
  • ANTHROPIC_API_KEY — BYOK; can be pasted here or set as env. UI takes precedence when both are set.
  • Settings → Telemetry privacy — metadata-only vs. content-redacted capture, plus the "preview what's shared" panel.
  • Settings → Connect to team — paste the linking code from repoops.ai/team to bind this desktop. Server-owned policy applies after binding.

Use it well

  1. Run the first-run wizard on a fresh install.

    It walks Settings → Repos → BYOK → Connect. You'll be in the dashboard with telemetry flowing in five minutes.

  2. Set up one Account per client up front.

    Then assign each tracked repo to its account so per-client cost rollups work from day one. You can rename, recolor, and reassign at any time — none of it affects historical telemetry.

  3. Paste BYOK once.

    The key persists across updates. If you regenerate the key (rotation, key leak), paste it again — the old one is overwritten on save.

  4. Connect to a team when you're ready.

    The linking code from repoops.ai/teamis one-time. After binding, server-owned policy pins your privacy floor — you can't accidentally over-share.

Examples

✓
Fresh install (Vince)
Run the wizard → pick the first repo → paste BYOK → skip team connect → land on Today with telemetry flowing. ~3 minutes.
⚠
Lost the BYOK key
The key is masked-only by design — there's no recovery. Regenerate a new key at the Anthropic console and paste it. Telemetry that was already captured stays intact; the new key only affects future LLM calls.

Read more