ADHDev Self-Hosted

April 24, 2026 · View on GitHub

ADHDev Self-Hosted is a self-hosted control plane for AI coding agent sessions. As agents become long-running background workers, ADHDev gives you one local dashboard to see which session is still running, waiting for approval, finished, stuck, or ready for the next instruction.

It is not trying to replace the underlying IDEs or agents. The goal is to give them a dedicated control surface: inspect active sessions, review chat and terminal state, approve or interrupt work, reopen the right history, and send the next instruction from one place.

For the standalone path, everything runs on your machine as a local daemon with an embedded web dashboard. No cloud account or hosted control plane is required.

Website: https://adhf.dev Docs: https://docs.adhf.dev

This repo contains the open-source, self-hosted edition:

the standalone local server and dashboard
the shared daemon/runtime packages used by both standalone and cloud
the session-host and terminal-mux stack for hosted CLI runtimes

Hosted cloud operations are not part of this repository.

Currently Working / Tested

These are the integrations currently working or explicitly tested enough to call out near the top:

IDEs: Cursor, Google Antigravity, VS Code, Kiro
IDE extension integrations: Codex, Claude Code
CLI agents: Hermes Agent, Codex CLI, Claude Code CLI

Other providers and adapters exist in the shipped inventory, but many are still incomplete, experimental, or not yet verified enough to present as fully supported. For the current support policy and caveats, see:

Screenshots

ADHDev desktop dashboard switching between chat and terminal views, floating a panel, and splitting the workspace

ADHDev desktop session detail view showing chat, code, and terminal state together

ADHDev completion notification demo showing when to come back to a running session

ADHDev mobile resume flow reopening a saved session from a phone

What It Runs

ADHDev Self-Hosted is built around three local layers:

daemon-standalone exposes a local HTTP/WebSocket server and serves the web UI.
daemon-core manages IDE, CLI, extension, and ACP integrations.
session-host-daemon (adhdev-sessiond) owns long-lived PTY runtimes so CLI sessions can survive daemon restarts.

Everything runs on your machine by default. There is no cloud account requirement for the standalone path.

Quick Start

Recommended path:

npm install -g adhdev
adhdev standalone

Direct standalone package:

npm install -g @adhdev/daemon-standalone
adhdev-standalone

Open http://localhost:3847.

Useful flags:

adhdev standalone --host
adhdev standalone --port 8080
adhdev standalone --token mysecret
adhdev standalone --no-open
adhdev standalone --dev

What those choices mean in practice:

plain adhdev standalone = localhost-only dashboard on this machine
--host = other devices on the same LAN can open it too
--token = best for scripts, curl, and operator-style access
dashboard password = best for normal browser users who should see a login prompt
--host with no token and no password = warning-first LAN exposure, not a hard block

Standalone stays localhost-only by default. If you bind to 0.0.0.0 for LAN access, the dashboard warns when neither token auth nor a dashboard password is configured.

The standalone UI already includes both settings surfaces:

Settings → Dashboard Security
- enable password
- update/change password
- disable password
Settings → Network Access
- save default localhost-only vs all-interfaces bind mode for future launches
Settings → Appearance → Fonts
- standalone-only overrides for chat text, markdown/code blocks, and terminal/tool rows
- saved alongside standalone network preferences under ~/.adhdev/standalone-network.json

Current standalone UX defaults:

ordinary CLI and ACP launches start fresh by default
use Open saved history when you want continuity in the same provider conversation
hosted runtime recovery is a separate interruption flow, not part of the ordinary new-session CTA
if the local dashboard drops its websocket connection, the banner now exposes Reconnect now

Canonical self-hosted docs:

Windows note:

Windows + Node.js 24+ is currently blocked for normal startup/install paths.
Use Node.js 22.x, or use the PowerShell installer path described in the docs.

Repository Layout

Path	Purpose
`packages/daemon-core`	Shared engine: providers, CDP, command routing, session/runtime state
`packages/daemon-standalone`	Local HTTP/WS server and bundled standalone UI
`packages/web-core`	Shared React pages, components, hooks, and transport abstractions
`packages/web-standalone`	Standalone dashboard app
`packages/web-devconsole`	Provider/dev diagnostics UI
`packages/session-host-core`	Session-host protocol, client, registry, ring buffer, labels
`packages/session-host-daemon`	Long-lived PTY runtime owner process
`packages/terminal-mux-*`	Local terminal mux stack
`packages/terminal-render-web`	Browser-side terminal rendering support
`packages/ghostty-vt-node`	Ghostty VT bindings used by runtime/mux layers

Provider Inventory

ADHDev ships a broad built-in inventory of IDE, extension, CLI, and ACP integrations, including 35 ACP adapters.

Important distinction:

built-in means the integration exists in the shipped inventory
verified means it has explicit validation evidence

Do not treat inventory presence as blanket support. Current verification policy lives here:

Standalone API Surface

The standalone server currently exposes:

GET /api/v1/status
POST /api/v1/command
GET /api/v1/runtime/:sessionId/snapshot
GET /api/v1/runtime/:sessionId/events
GET /api/v1/mux/:workspace/state
GET /api/v1/mux/:workspace/socket-info
POST /api/v1/mux/:workspace/control
GET /api/v1/mux/:workspace/events
ws://localhost:3847/ws

Canonical runtime contract:

GET /api/v1/status and its sessions[] array are the source of truth
runtime targeting should use raw targetSessionId
older per-surface projections should be treated as convenience views, not the canonical model

Reference:

Session Host

Hosted CLI runtimes are managed through adhdev-sessiond.

Key properties of the current design:

PTY ownership is separated from the main daemon process
CLI sessions can reconnect after daemon restarts
write ownership is explicit and single-owner
diagnostics and recovery actions are exposed through the daemon control plane and standalone UI

See:

Development

From source:

git clone https://github.com/vilmire/adhdev.git
cd adhdev
npm install
npm run build
npm run dev

Useful workspace scripts:

npm run dev:daemon
npm run dev:web
npm run dev -w packages/web-devconsole

Documentation

Cloud Comparison

Feature	OSS	Cloud
Local-only dashboard	✅	✅
Remote access outside LAN	❌	✅
Multi-machine management	❌	✅
API keys and hosted webhooks	❌	✅
OAuth / account system	❌	✅
Push notifications	❌	✅
Team / sharing features	❌	✅

License

AGPL-3.0-or-later. See LICENSE.