# @adhdev/daemon-core

> ADHDev daemon core — CDP, IDE detection, providers, command execution

Latest version **1.0.59** (published 2026-09-16) · AGPL-3.0-or-later license · 0 weekly downloads

## Install

```sh
npm install @adhdev/daemon-core
pnpm add @adhdev/daemon-core
yarn add @adhdev/daemon-core
bun add @adhdev/daemon-core
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads; large bundle.

## Facts

| | |
|---|---|
| Version | 1.0.59 |
| Published | 2026-09-16 |
| First published | 2026-03-20 |
| Weekly downloads | 0 |
| License | AGPL-3.0-or-later |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 13 |
| Unpacked size | 52.6 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 55 |
| Author | vilmire |
| Maintainers | vilmire |
| Keywords | adhdev, daemon, cdp, ide-detection |

## Links

- npm: https://www.npmjs.com/package/@adhdev/daemon-core
- Repository: https://github.com/vilmire/adhdev
- Homepage: https://github.com/vilmire/adhdev#readme
- Issues: https://github.com/vilmire/adhdev/issues
- npm.io page: https://npm.io/package/@adhdev/daemon-core

## Dependencies (13)

- [ws](https://npm.io/package/ws.md) ^8.19.0
- [ajv](https://npm.io/package/ajv.md) ^8.20.0
- [conf](https://npm.io/package/conf.md) ^13.0.0
- [chalk](https://npm.io/package/chalk.md) ^5.3.0
- [tar-fs](https://npm.io/package/tar-fs.md) ^3.1.0
- [js-yaml](https://npm.io/package/js-yaml.md) ^4.1.1
- [chokidar](https://npm.io/package/chokidar.md) ^4.0.3
- [node-pty](https://npm.io/package/node-pty.md) ^1.2.0-beta.12
- [ajv-formats](https://npm.io/package/ajv-formats.md) ^3.0.1
- [better-sqlite3](https://npm.io/package/better-sqlite3.md) ^12.10.0
- [@adhdev/mesh-shared](https://npm.io/package/@adhdev/mesh-shared.md) *
- [@agentclientprotocol/sdk](https://npm.io/package/@agentclientprotocol/sdk.md) ^0.16.1
- [@adhdev/session-host-core](https://npm.io/package/@adhdev/session-host-core.md) *

## Alternatives

- [@sindresorhus/slugify](https://npm.io/package/@sindresorhus/slugify.md) — 3.7M weekly downloads
- [solid-js](https://npm.io/package/solid-js.md) — 2.7M weekly downloads
- [expo-glass-effect](https://npm.io/package/expo-glass-effect.md) — 2.5M weekly downloads
- [nanoassert](https://npm.io/package/nanoassert.md) — 780.8K weekly downloads
- [@ffmpeg/ffmpeg](https://npm.io/package/@ffmpeg/ffmpeg.md) — 529.5K weekly downloads

## Recent versions

- 1.0.59 (latest) — 2026-09-16
- 1.0.60-rc.21 (next) — 2026-09-20
- 1.0.60-rc.20 — 2026-09-19
- 1.0.60-rc.19 — 2026-09-19
- 1.0.60-rc.18 — 2026-09-19
- 1.0.60-rc.17 — 2026-09-19
- 1.0.60-rc.16 — 2026-09-19
- 1.0.60-rc.15 — 2026-09-19
- 1.0.60-rc.14 — 2026-09-19
- 1.0.60-rc.13 — 2026-09-19
- 1.0.60-rc.12 — 2026-09-19
- 1.0.60-rc.11 — 2026-09-19
- 1.0.60-rc.10 — 2026-09-18
- 1.0.60-rc.9 — 2026-09-18
- 1.0.60-rc.8 — 2026-09-18
- … 1454 more at https://npm.io/package/@adhdev/daemon-core/versions

## README

# @adhdev/daemon-core

ADHDev daemon core — the shared engine behind every ADHDev daemon: provider integrations, command routing, and session/runtime state. It is a library, not a standalone process; `@adhdev/daemon-standalone` embeds it for the self-hosted path, and the cloud daemon builds on the same core.

## What It Owns

- **Providers** — the four integration categories:
  - `ide` — IDEs driven over the Chrome DevTools Protocol (Cursor, VS Code, Windsurf, …)
  - `extension` — IDE extensions reached through CDP webviews (Claude Code, Cline, Roo Code, …)
  - `cli` — terminal agents driven over PTYs (Claude Code, Codex CLI, Kimi Code, Grok CLI, …)
  - `acp` — agents speaking the Agent Client Protocol over stdio
- **Provider SDK** (`src/providers/sdk`) — the versioned, typed contract that external provider manifests are authored against.
- **Command routing** — the typed command surface (`send_chat`, `approve`, launch/stop, git operations, …) that the HTTP/WebSocket API, the MCP server, and the dashboard all converge on.
- **Session & runtime state** — session lifecycle, runtime recovery, and the normalized status model shared with the web clients.
- **Terminal screen model** (`src/cli-adapters`) — the VT parser + screen snapshot layer (`TerminalScreen`, ghostty-vt/xterm backends) used to read CLI agent output. See [docs/libghostty-vt.md](../../docs/libghostty-vt.md).
- **Mesh & quota** — mesh event normalization and per-provider plan-quota fetchers.

## Layout (src/)

| Directory | Responsibility |
| --- | --- |
| `providers/` | Provider specs, detection, and the Provider SDK |
| `cli-adapters/` | PTY transport, `TerminalScreen`, CLI runtime plumbing |
| `cdp/` | Chrome DevTools Protocol clients for IDEs/extensions |
| `commands/` | Command handlers and stream commands |
| `sessions/` | Session lifecycle and state |
| `session-host/` | Client for the `adhdev-sessiond` PTY-owning runtime |
| `mesh/` | Repo-mesh event types and normalization |
| `quota/` | Provider plan-quota fetchers |

## Development

```bash
npm run build -w packages/daemon-core      # tsup + type declarations
npm test -w packages/daemon-core           # vitest
npm run typecheck -w packages/daemon-core
```

Consumers import the compiled entrypoints declared in `package.json` `exports` (e.g. `@adhdev/daemon-core`, `@adhdev/daemon-core/status/normalize`).

---
_Source: https://npm.io/package/@adhdev/daemon-core · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
