<div align="center">
AI Operations Dashboard
One local page for everything Claude is doing across your projects.
Open work · recent activity · AI spend · plans · postmortems — every operator signal on a single, auto-refreshing page, read straight from files on your Mac. No database. Nothing in the cloud. Your data never leaves your computer.
!Next.js 16 !React 19 !Node 20+ !8 themes !runs local
</div>
Built for solo founders and indie hackers running AI projects across several repos at once. Connect each repo, and as Claude works, the dashboard shows everything happening — in one place. Every panel is a server component that reads flat files (Markdown + JSON) from your repo, so the dashboard versions itself alongside your code and there's nothing to provision.
Quick start (Mac, ~2 minutes)
# 1. Get it — in its OWN folder, not inside another project
git clone <your-repo-url> ai-ops-dashboard
cd ai-ops-dashboard
# 2. Install + run
npm install
npm run devOpen <http://localhost:3000>. You'll see a populated demo so you can explore every panel. When you're ready to use it for real:
npm run reset # clears the demo data — leaves ONLY your data, nothing mixed in
npm run setup # name + brand it (optional)Requirements: macOS · Node.js 20+ · git. (Claude Code too, for the live feed.)
> 👉 New here? Follow [`SETUP-GUIDE.md`](./SETUP-GUIDE.md) — the complete, > beginner-friendly walkthrough: install, clear the demo, connect your repos, > and wire Claude to feed the dashboard live.
How it works
- It reads flat files. Panels read Markdown + JSON from
data/,docs/,
plans/, knowledge/. The repo *is* the database.
- Claude feeds it. In each project you connect (one
ai-ops-dashboard init
command), a small CLAUDE.md tells Claude to report what it ships via the dashboard's CLI. The page auto-refreshes every 120s, so you watch activity across every repo live. → `SETUP-GUIDE.md` Parts 4–5
- You make it yours. One file —
`ai-ops-dashboard.config.ts` — controls branding, theme (8 built in), and tabs. Show/hide any tab live in the app under ⚙ Tabs.
The tabs
Overview · Plan · Sprints · Activity · Pending · Operator Log · Postmortems · Usage (AI spend) · Scheduled Jobs · Docs · Token Savings & Skills (hidden by default — they need extra setup; enable under ⚙ Tabs) · plus your own custom tabs (npm run new:panel).
Common commands
> Run every npm run … command from inside the dashboard folder (cd into > it first). npm error … Could not read package.json means you're in the wrong > directory.
| Command | What it does | | --- | --- | | npm run dev | Run the dashboard at localhost:3000 | | npm run reset | Clear the demo content → your data only (keeps your connected repos + branding) | | npm run setup | Guided branding/config wizard | | npm run build | Production build | | npm run package | Build a shareable .zip of the product into dist/ | | ai-ops-dashboard init --dashboard <path> | Connect a project repo (run inside that repo) | | ai-ops-dashboard status | Check a connected repo's link |
Docs
- `SETUP-GUIDE.md` — full step-by-step install + Claude wiring (start here).
- `help/` — configuration · connecting repos · panels · custom tabs · FAQ.
- `PRODUCT.md` / `DESIGN.md` — product + design intent.
- `AGENTS.md` / `CLAUDE.md` — the contract for AI agents operating the dashboard.
- `LICENSE` — usage terms.