🦦 ADHDev — Agent Dashboard Hub for Dev

Your AI sidekick otter 🦦 — control your IDE's AI agents from anywhere.

ADHDev is an open-source local dashboard for managing AI coding agents across multiple IDEs. Run it on your machine — no cloud account required.

✨ What Does It Do?

┌──────────────────────────────────────┐      ┌──────────────────┐
│  Your Local Machine                  │      │  Web Dashboard   │
│  ┌──────────┐    ┌────────────────┐  │      │  (React SPA)     │
│  │ IDE      │    │ ADHDev Daemon  │──┼──────┼▶ Chat, Commands, │
│  │ + AI Ext │CDP │ localhost:3847 │  │ HTTP │  Screenshots,    │
│  └──────────┘    └────────────────┘  │  /WS │  Remote Control  │
│                                      │      │                  │
│  CLI Agents  ◄─PTY─►  Daemon        │      │                  │
│  ACP Agents  ◄─stdio─► Daemon       │      └──────────────────┘
└──────────────────────────────────────┘
       Everything runs locally — no cloud required

• Read & send messages to AI agents (Cursor, Cline, Roo Code, Claude Code, Gemini CLI, etc.)
• See IDE screenshots in real-time via Chrome DevTools Protocol
• Remote desktop — click, type, scroll in your IDE from the browser
• Manage CLI agents — interactive terminal view with xterm.js
• Multi-IDE support — manage multiple IDEs simultaneously
• Provider system — extensible via provider.js files (no TypeScript changes needed)

🚀 Quick Start

# One-line installer (recommended — handles Node.js check + install + setup)
curl -fsSL https://adhf.dev/install | sh

# Or install via npm directly
npm install -g adhdev

# One-liner — starts dashboard at http://localhost:3847
adhdev standalone

# With options
adhdev standalone --port 8080 --host   # LAN access
adhdev standalone --token mysecret     # Token auth

On Windows, prefer:

irm https://adhf.dev/install.ps1 | iex

The Windows one-line installer bootstraps a portable Node.js 22 runtime when Node is missing or Node 24+ is installed.

That's it! Open http://localhost:3847 and your connected IDEs will appear automatically.

CLI Options

Flag	Description
--port, -p <port>	Port to listen on (default: 3847)
--host, -H	Listen on all interfaces — enables LAN access (0.0.0.0)
--no-open	Don't open browser automatically on start
--token <secret>	Enable token authentication for API and WebSocket
--dev	Enable DevServer on port 19280 (provider debugging, CDP tools)

📦 Packages

Package	Description
packages/daemon-core	Shared engine — CDP, IDE detection, provider loader, command routing, CLI/ACP adapters
packages/daemon-standalone	Self-hosted local server — HTTP REST + WebSocket + bundled dashboard
packages/web-core, packages/web-standalone, packages/web-devconsole	Shared UI, standalone dashboard, and provider debugging UI
packages/session-host-core, packages/session-host-daemon	Local session registry and long-lived session runtime (adhdev-sessiond)
packages/terminal-mux-core, packages/terminal-mux-control, packages/terminal-mux-cli	Terminal mux stack (adhmux) for live local sessions
packages/terminal-render-web	React terminal rendering package for the dashboard
packages/ghostty-vt-node	Ghostty virtual terminal bindings used by the mux stack

💡 Cloud version with remote access and team features available at adhf.dev

🔌 Supported IDEs & Agents

IDE Support Status

We are actively building out providers. Here is the current capability tracking:

• 🟢 Antigravity — Stable (CDP)
• 🟢 Cursor — Stable (CDP)
• 🟢 Windsurf — Stable (CDP)
• 🟢 Kiro — Stable (webview CDP)
• 🟡 PearAI — Beta (webview CDP)
• 🟡 Trae — Beta (webview CDP)
• 🟡 VS Code / VSCodium — Infrastructure ready (WIP)

AI Extensions (via Agent Stream CDP scraping)

• 🟢 Cline — Independent Stream
• 🟢 Roo Code (3.x, 4.x) — Independent Stream
• 🟢 Codex Extension — Independent Stream
• 🟢 Cursor Composer — Native agent mode integration

Standalone CLI Agents (via Daemon CLI Adapters)

All CLI agents support interactive Terminal mode. Chat mode (UI abstraction) availability is listed below:

• 🟢 Claude Code — Terminal + Chat Mode
• 🟢 Codex CLI — Terminal + Chat Mode
• 🟡 Aider — Terminal only (Chat Mode WIP)
• 🟡 Cursor CLI — Terminal only (Chat Mode WIP)
• 🟡 Gemini CLI — Terminal only (Chat Mode WIP)
• 🟡 GitHub Copilot CLI — Terminal only (Chat Mode WIP)
• 🟡 Goose CLI — Terminal only (Chat Mode WIP)
• 🟡 OpenCode CLI — Terminal only (Chat Mode WIP)

ACP Agents (Agent Client Protocol — 35 agents)

• ✅ 35 ACP agents supported (Gemini, Codex, Claude Agent, Cursor, Cline, GitHub Copilot, Goose, Kimi, Kiro, Mistral Vibe, OpenCode, Qwen Code, and 21 more)

🛠️ Development

# Clone and install
git clone https://github.com/vilmire/adhdev.git
cd adhdev
npm install

# Build all packages (order matters)
npm run build

# Run standalone (daemon + dashboard)
npm run dev

# Individual services
npm run dev:daemon    # daemon-standalone only
npm run dev:web       # web-standalone only (Vite dev server)
npm run dev -w packages/web-devconsole

Project Structure

packages/
├── daemon-core/           # Core engine (CDP, providers, CLI/ACP adapters, lifecycle)
├── daemon-standalone/     # HTTP/WS server (localhost:3847)
├── session-host-core/     # Session registry + transport protocol
├── session-host-daemon/   # Long-lived session runtime (adhdev-sessiond)
├── terminal-mux-core/     # Terminal mux runtime
├── terminal-mux-control/  # Control/storage/socket helpers
├── terminal-mux-cli/      # adhmux CLI
├── terminal-render-web/   # React terminal renderer
├── ghostty-vt-node/       # Ghostty VT bindings
├── web-core/              # Shared React components, pages, CSS design system
├── web-standalone/        # Standalone React dashboard (Vite)
└── web-devconsole/        # DevConsole — provider debugging tools

🔗 Local API

The standalone daemon exposes a REST API at http://localhost:3847:

# Get daemon status (connected IDEs, system info)
curl http://localhost:3847/api/v1/status

# Send a chat message to an IDE agent
curl -X POST http://localhost:3847/api/v1/command \
  -H 'Content-Type: application/json' \
  -d '{"type": "send_chat", "payload": {"message": "Fix the login bug"}, "target": "standalone:ide:cursor_12345"}'

# Read current chat
curl -X POST http://localhost:3847/api/v1/command \
  -H 'Content-Type: application/json' \
  -d '{"type": "read_chat", "target": "standalone:ide:cursor_12345"}'

# Take a screenshot
curl -X POST http://localhost:3847/api/v1/command \
  -H 'Content-Type: application/json' \
  -d '{"type": "screenshot", "target": "standalone:ide:cursor_12345"}'

# List connected IDEs
curl http://localhost:3847/api/v1/ides

# List CLI sessions
curl http://localhost:3847/api/v1/clis

Full API spec: openapi.yml (OpenAPI 3.0)

🧩 Web Dashboard Features

Feature	Description
Dashboard	Real-time agent chat, CLI terminal, agent management
IDE Detail	Full IDE control — chat, remote desktop, view modes
Machine View	IDE/CLI instance listing & management
CLI Terminal	Interactive terminal with xterm.js (Catppuccin Mocha theme)
Mobile UI	Responsive design — works on phones and tablets
Provider Settings	Per-provider configurable settings with runtime hot-reload

🔌 Adding New IDE/Agent Providers

Providers are dynamically loaded from the vilmire/adhdev-providers repository. Your local daemon downloads the latest upstream set into ~/.adhdev/providers/.upstream/ and lets user overrides in ~/.adhdev/providers/<category>/<type>/ win.

If you want to create a custom provider locally, use ~/.adhdev/providers/<category>/<type>/:

~/.adhdev/providers/ide/my-ide/
  provider.json
  scripts/
    1.0/
      scripts.js

🗺️ Roadmap

• IDE detection (8 IDEs — Cursor, Antigravity, Kiro, PearAI, Trae, Windsurf, VS Code, VSCodium)
• CDP integration (Chrome DevTools Protocol)
• Agent Independent Chat Streams (Cline, Roo Code — real-time CDP scraping)
• CLI Agent Adapters (Gemini CLI, Claude Code, Codex CLI — PTY-based)
• ACP 35 agents (Agent Client Protocol — MCP stdio)
• Interactive Terminal View (xterm.js — full TUI rendering)
• Provider architecture (4-category provider.js system)
• Model/Mode selection (CDP-based switching for all IDEs)
• Mobile responsive UI
• Provider Settings System (per-provider configurable settings)
• MCP server integration
• JetBrains plugin

📚 Documentation

🌐 docs.adhf.dev — User guides, feature docs, troubleshooting

• openapi.yml — Standalone REST API specification (OpenAPI 3.0)
• CONTRIBUTING.md — How to contribute to ADHDev core
• Provider Development: See vilmire/adhdev-providers for the provider contribution guide.

☁️ Cloud Version — adhf.dev

Need remote access, team collaboration, or API integration?

Feature	OSS (this repo)	Cloud
IDE/CLI agent chat & control	✅	✅
IDE + 35 ACP support	✅	✅
Remote access (outside LAN)	❌	✅
Multi-machine management	❌	✅
Session Sharing (live link)	❌	✅
Team / Organization	❌	✅
REST API + Webhooks	Local only	✅ Cloud API
OAuth (GitHub/Google)	❌	✅
Push notifications	❌	✅

→ Get started with ADHDev Cloud

📜 License

AGPL-3.0 — See LICENSE for details.