The Codmir daemon — a local AI workstation running on your machine, shared by the desktop app and IDE extension

Daemon

The Codmir daemon is a long-running process on your machine that powers the AI agent experience across all Codmir clients. It runs a WebSocket server on ws://127.0.0.1:7700 and provides:

• Agent sessions — an agentic loop that calls Claude with tool use, executes tools locally, handles approval gates
• Process management — a priority-based task queue with concurrent execution
• Overseer — a background observer that watches your editor activity and generates suggestions
• Mesh networking — peer-to-peer discovery of other Codmir daemons on your network for distributed task routing

Why a daemon?

The daemon exists so that AI agent work survives independently of any UI. When you close the desktop app or IDE, the daemon keeps running. When you reopen, your agent sessions are still there.

It also provides a single coordination point — the desktop app and IDE extension both connect to the same daemon over WebSocket, sharing agent sessions, tool history, and context.

Desktop App (Tauri)  ─┐
                      ├──→ Daemon (ws://127.0.0.1:7700)  ──→ Anthropic API
IDE Extension (VS Code) ┘           │
                                    ├──→ Tool execution (shell, files, search)
                                    ├──→ Overseer (editor signal processing)
                                    └──→ Platform (heartbeat to codmir.app)

Getting started

The daemon starts automatically when you open the desktop app or activate the IDE extension. You can also start it manually:

codmir daemon start

See Architecture for the full system design, Agent Protocol for the WebSocket message format, and Lifecycle for how clients manage the daemon process.