A local-first command center for your GitHub work.
See every repo, PR, and signal across all your orgs in one place — without a backend, without trackers, without giving your token to anyone.

GitHub is great at one repo at a time. It is slow at the questions developers actually ask every morning:

• Which of my repos got activity yesterday?
• Where are PRs waiting on me?
• Which open PRs across all my orgs have failing CI?
• Did my token authorize the org I expected, or did SSO silently block it?
• Can I reload the page without waiting 30 seconds for a full GitHub sync?

devcompass answers those from one dense, fast UI built for people who work across many GitHub orgs and switch context often.

• Digest scope — operational snapshot of the last 24h / 7d / 30d. Top stat tiles, GitHub-style contribution heatmap, most active repos, open-PR contributors, "needs attention" rows.
• Needs me — every PR where you're a requested reviewer or co-author (with head → base branch badges + filters), plus failed production deploys and a discoverable review pool.
• Connectors — bring-your-own-key for Sentry (issues + errors) and Vercel (deployments), forwarded through a strict same-origin relay. One Connectors hub + a Relationships matrix that lines up each repo with its Sentry project and Vercel deployment.
• Since last visit — diff feed of what changed since you last marked the home as seen.
• All repos — every visible repo (yours + member orgs + collaborator orgs), filtered by org chip, language, activity window, search.
• Repo detail — Overview / Commits / PRs / Issues / Releases, with branch chips on each commit and merged-PR history.
• Local-first — IndexedDB caches repos, PR detail, branches, orgs, viewer info, and the contribution calendar (TTL-bound, auto-pruned). Reloads paint instantly.
• Privacy by design — your Personal Access Token lives in localStorage, nothing is sent to any server we control. No analytics. No tracking. No cookies.

View	Screenshot
Digest — operational snapshot + heatmap
All repos — chip filters + scan grid
Repo detail — tabs + commit branches
Login — token entry + scope explainer
Settings → Cache — TTL-bound IDB inspector

This is a single-page app that talks directly to GitHub from your browser. There is no backend. There is no analytics. There is no telemetry.

You can wipe all local state from Settings → Storage → Clear all cache. The token UI also masks the PAT (***) so it never paints to the DOM.

devcompass needs a GitHub classic Personal Access Token with:

• repo
• read:org

Create one at https://github.com/settings/tokens. If an org appears missing after login, check Settings → Token — the panel surfaces X-OAuth-Scopes and X-GitHub-SSO from the API response so you can see whether SSO authorization is missing for that org.

Fine-grained tokens work for personal repos but currently miss organization repos due to GraphQL viewer.organizations requiring read:org (a classic scope). Classic tokens are recommended.

git clone https://github.com/dPeluChe/devcompass.git
cd devcompass
npm install
npm run dev

Open http://localhost:8099, paste your token, done.

To build a static bundle you can drop on Netlify / Vercel / GitHub Pages / S3:

npm run build
# outputs to dist/

There is no backend — dist/ is everything.

First time visiting? The app will ask for a Personal Access Token. The page never sends it anywhere except api.github.com — verify in your browser DevTools → Network if you want to confirm.

┌─ React 19 + Vite 6 SPA ──────────────────────────────────────┐
│                                                                │
│  ┌─ TanStack Query ─────┐    ┌─ Zustand (persist) ──────────┐ │
│  │ in-memory cache     │    │ per-org enabled / syncEnabled │ │
│  │ react-renderer key   │    │ stored in localStorage         │ │
│  └──────────────────────┘    └────────────────────────────────┘ │
│                                                                │
│  ┌─ Dexie / IndexedDB (db name: devcompass, v4) ───────────────┐ │
│  │ repos · orgs · prefs · pinnedRepos · snoozedPRs           │ │
│  │ TTL-bound prefs cache with auto-prune                      │ │
│  └────────────────────────────────────────────────────────────┘ │
│                                                                │
│  ┌─ src/api/{github,sentry,vercel} (no SDK) ────────────────┐ │
│  │ GitHub direct · Sentry/Vercel via api/_relay (allowlist)  │ │
│  │ retries 3x on transient failures                          │ │
│  └────────────────────────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────────────┘

For a deeper tour of the source tree, see docs/README.md.

• React 19 + Vite 6 + TypeScript 5.7 (strict)
• TanStack Query 5 for server-state caching
• Dexie for IndexedDB persistence
• Zustand for UI/config state
• React Router 7 for nested routes
• DOMPurify for safe PR markdown
• Framer Motion (lazy-loaded) for animations
• react-icons + lucide-react for iconography

devcompass started as a GitHub-only workbench, but the scope/digest concepts are designed to grow. On the near horizon:

• Watching scope — auto-derived: PRs you authored awaiting reviewers, PRs you review-requested that went draft, pinned repos with no recent activity.
• Digest v2 — sparklines per repo, PRs merged in window, avg time-to-merge, top commit-contributors.
• Cross-platform — once the GitHub story is solid, plug GitLab / Bitbucket / Linear into the same scope model.

The full backlog lives in docs/TASK_TODO.md. Issues and PRs welcome.

PRs and issues are welcome. Before opening a PR:

1. Run npm run check — lint + tests + build must all pass (0 errors).
2. Follow the commit-message style in recent history (feat(scope): …, fix(scope): …).
3. Keep PRs focused: one logical change per PR.
4. No backend, no analytics, no telemetry — privacy is a core feature.
5. Use <ConfirmDialog> instead of native confirm() / alert() / prompt().
6. Render any GitHub-supplied HTML through <SanitizedMarkdown> (DOMPurify).

MIT © 2026 Antonio Martinez Quintero. Use it, fork it, ship it.