quickstart
- Node: `24.14.0` from `.nvmrc` - Package manager: `pnpm@10.28.2` - Workspace layout: pnpm monorepo; the Electron app lives in `apps/emdash-desktop/`
How it fires
How this agent gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
Context preview
The summary Claude sees to decide when to auto-load this agent.
- Node: `24.14.0` from `.nvmrc` - Package manager: `pnpm@10.28.2` - Workspace layout: pnpm monorepo; the Electron app lives in `apps/emdash-desktop/`
Agent definition
quickstart.mdQuickstart
Toolchain
- Node: `24.14.0` from `.nvmrc`
- Package manager: `pnpm@10.28.2`
- Workspace layout: pnpm monorepo; the Electron app lives in `apps/emdash-desktop/`
Core Commands
Run from `apps/emdash-desktop/` (the root `package.json` also provides `dev` and `build` aggregates that delegate via `pnpm --filter`):
pnpm run d pnpm run dev pnpm run dev:main pnpm run dev:renderer pnpm run build pnpm run rebuild pnpm run reset
Validation Commands
Run from the repo root (they fan out to the workspace) or from `apps/emdash-desktop/`:
pnpm run format pnpm run lint pnpm run typecheck pnpm run test
Important Notes
- After native dependency changes (`better-sqlite3`, `node-pty`), run `pnpm run rebuild`.
- There are no pre-commit hooks; run the validation commands before opening or merging a PR.
Emdash is the Open-Source Agentic Development Environment (🧡 YC W26). Run multiple coding agents in parallel. Use any provider.
Repo: generalaction/emdash
Other agents on emdash.
- acp-runtime
The ACP runtime is the domain service that serves the ACP API contract. It owns the host-scoped dependencies needed to run provider ACP sessions, but it should not mix cross-session routing with per-session state projection.
Open agent - main-process
The main process is organized into domain modules under `src/main/core/`. Each domain typically has a `controller.ts` (RPC handlers) and service/implementation files.
Open agent - overview
All paths are relative to `apps/emdash-desktop/`.
Open agent - renderer
All paths are relative to `apps/emdash-desktop/`.
Open agent - shared
- Agent/provider DTOs: - `src/shared/core/agents/agent-payload.ts` - provider metadata and capabilities are sourced from `packages/plugins/src/agents/registry.ts` - IPC primitives: - `src/shared/ipc/rpc.ts` — typed RPC router, controller, and client - `src/shared/ipc/events.ts`
Open agent - workspace-server
The Workspace Server (`apps/workspace-server/`) is a Node daemon that runs on a remote machine and exposes workspace runtimes (git, files, deps, ACP, …) to Emdash clients over the `@emdash/wire` protocol. Clients connect over an SSH-forwarded Unix socket; the daemon is
Open agent