ADE (Agent Development Environment) — multi-harness operator for Claude, Cursor, Codex, Grok, and other coding agents.
Repository: jtmilan/agent-commandcenter
For operators: Run multi-agent fleets on your Mac — workspaces, MCP, merge gate, and handoff. Plans and promos are managed via ade-api (coupons, credits, trials); local worktrees keep working even when cloud extras soft-gate.
| Product target | Tauri native app (macOS first; Windows & Linux next) |
| Why not web-only? | Terminal harnesses need local PTY, filesystem, git worktrees, and MCP stdio — browsers cannot spawn them |
What npm run dev is |
UI-only Vite preview for layout/features — not a production harness host |
| Real harnesses | Only when running inside Tauri (src-tauri + agent-bridge plugins) |
If you clone this repo expecting a website that runs agents in the cloud: that is not the architecture.
Ship and use the macOS (or other desktop) app built with Tauri.
Billing/API stays separate: jtmilan/ade-api (no Stripe secrets in the desktop binary).
→ Full clone & build steps: docs/DESKTOP-BUILD.md
→ Local rebuild + manual test handover: docs/LOCAL-HANDOVER.md
- Command Center — workspace tree, multi-pane fleet, drag-and-drop
- Sub-linear layout — pin, focus grid, stack, resize, auto-arrange
- Safety — worktree destroy confirmation + path-scoped destroy
- Agent bridge — Claude-first spawn + job events; Tauri process host; mock PTY in UI preview
- Close safety — kill job → path-scoped worktree destroy (async confirm)
- Status bus — host needs_input / tool_fail / exit → panes + Timeline
- Soft-gates — signed entitlements from ade-api (HMAC); credit vs upgrade
- Wizard + Mission — recipe-first setup + welcome activation
- MCP Control Center — single config; Org MCP policy (Team)
- Operator suite — inbox, heat map, timeline, runbook, Diff/PR, merge, handoff
- Personas — Operator / Admin / Viewer same shell
- Themes — dark / light / system
- Settings — Appearance, Billing/Usage, architecture docs
→ Build path details: docs/BUILD-PATH.md
- macOS 12+ (Apple Silicon or Intel)
- Xcode Command Line Tools
- Rust stable
- Node.js 20+
- npm
- Windows 10/11 + MSVC build tools
- Linux (webkit2gtk deps) — see Tauri prerequisites
git clone https://github.com/jtmilan/agent-commandcenter.git
cd agent-commandcenter
npm install
# Install Tauri CLI (once)
npm install -D @tauri-apps/cli@2
# or: cargo install tauri-cli --version "^2"
# Scaffold native shell if src-tauri is not present yet:
# npm run tauri init # only when setting up from scratch
# Dev: native window (preferred for product work)
npm run tauri dev
# Release .app / dmg (macOS)
npm run tauri buildExpected outcome of tauri build on Mac: a native .app (and optional DMG), not a deployable SPA for hosting harnesses on a server.
npm run dev # Vite on port 8080 — mock fleet only
npm run typecheck
npm run build # web bundle for embedding in Tauri webviewUse npm run dev to iterate on React UI. Use npm run tauri dev when you need the desktop host path.
| Layer | Tech |
|---|---|
| UI | React 19 · TypeScript · Vite · TanStack · Tailwind v4 |
| Desktop host | Tauri 2 (Rust plugins, capabilities, IPC) |
| Billing API | ade-api (separate repo) |
| Document | Description |
|---|---|
| docs/LOCAL-HANDOVER.md | ★ Clone, rebuild, manual test (start here) |
| docs/DESKTOP-BUILD.md | Tauri / macOS build detail |
| docs/PRD-HANDOVER.md | Product requirements v2 |
| docs/BUILD-PATH-V2.md | Host path top 5 |
| docs/ENTITLEMENTS-PROTOCOL.md | Signed entitlements |
| docs/ADE-API.md | Companion backend |
| docs/GROWTH-ENGAGEMENT-API.md | Coupons, credits, marketing |
| docs/ASYNC-CAPABILITIES.md | Capabilities + async host |
| docs/HMAC-WEBHOOK-VERIFICATION.md | Webhook HMAC |
| docs/RECOMMENDATIONS-CHECKLIST.md | Integration checklist | | docs/ARCHITECTURE-ANALYSES.md | Plugin / security analyses |
- Open demo — sample multi-agent fleet (mock until host wired)
- Features strip — Inbox → MCP
- Settings (⌘,) — Appearance · Billing · Architecture
- ⌘K — command palette
jtmilan/ade-api— Stripe webhooks, entitlements, usage- Upstream research may live in
jtmilan/harness-ready
Private / product terms unless otherwise noted by owner.