Docs

Integrations

One page per vendor - env vars, install steps, failure mode, monthly cost. Every external service the project touches: what it does for you, what it costs, how it fails, the env vars that wire it up.

See it in motion

Where to find it

  • Desktop: localhost:4000, then Local settings in the sidebar, then Integrations under Workspace utilities.
  • Hosted: repoops.ai/team/reference, from Memory in the sidebar, then Reference index under All tools, in the Lessons, wiki and patterns group, which lists it.
  • Keyboard: ⌘ K, then type “Integrations”.
  • On disk: .claude/brain/integrations.md

What it does for you

Every vendor, every env var, in one place.No hunting through code for which keys map to which service. Most integration rows list the env vars they read and what happens when those are missing; rows for a vendor that needs setup add the install steps.
Cost is part of most rows.Most vendors carry a Cost ceiling line, either a dollar figure, a free-tier limit, or a note that nothing is billed because the work runs locally. Some rows still have none, so check the row before you price a switch.
Failure mode is named, not surprising.Most rows say what the integration returns on auth failure, rate limit, or upstream outage.

Configure

Wire each integration through its env vars (registered in config.md). New integration → new row here in the same PR.

Production sources from the Integrations card

Five production sources connect from Settings, Integrations on the local app, one card per repo: Sentry, Vercel, PostHog, a database slow log and, since 2026-09-13, GitHub. Each card takes the service's identity (a project id, an org and slug, an owner and repository) and a token. The token goes into the machine's data-dir .env under the env var the card names; the identity goes into the repo's runtime row. Nothing is written into the tracked repository, and repos.config.json stays optional for a repo added through the app.

  • GitHub. Four reads, each a leg in the source registry: failed workflow runs, code-scanning alerts, secret-scanning alerts and Dependabot alerts. A failed run on the default branch opens a case on sight; a run on another branch or a pull request opens by recurrence. Alerts open at the severity GitHub stamped (a Dependabot alert at its advisory's severity), never at a word from a description. The token needs repo, actions:read and security_events on that repository; a repository with an alert kind turned off answers 403 and the card says so rather than reporting no problems. Enabling starts a 30-day backfill, then the pull runs every 15 minutes.
  • Vercel log drain. Runtime 5xx invocations arrive as a push, not a pull. The Vercel card shows the URL to add as a Log Drain (JSON format, sources Lambda and Edge) and whether the drain's signing secret is set under VERCEL_LOG_DRAIN_SECRET. Every batch is checked against that secret; with none set, every batch is refused. Each 5xx invocation opens a production case keyed on the request id, with the deployment and, when the Vercel pull has seen it, the commit attached. Today lists the drain as a source once the secret is set and credits production only after a batch arrives. On the hosted app the same push lands on a Vercel log drain connector: connect one under Team, Connectors with the drain's signing secret and the repository, then point the Log Drain at the path the connector's card shows. Every batch is checked against the stored secret, a batch that does not verify is refused, and each 5xx invocation opens the same production case, keyed on the request id, under that repository.

What a card claims is what the source registry names, so the Today page's "no source" reads stay honest: Vercel usage, cost and manual problems have no observing source on the local app and Today says so.

Use it well

Before adding a new vendor, scan this list - there's a good chance an existing integration already does what you need. When you do add one, log the env vars, the install steps, and the failure mode in the same PR. Cost goes in the row.

Read more

Last updated