@cowow/daemon

ACP bridge daemon for cowow. Dials a remote cowow-acp-proxy over WebSocket, hosts a ClaudeAcpAgent per ACP connection, and injects cowow's MCP server into every session/new so Claude has the knowledge graph available out of the box.

┌────────────┐   ws (outbound)   ┌──────────────────┐   ws    ┌──────────────┐
│ cowow      │ ────────────────► │ cowow-acp-proxy  │ ◄────── │ Flutter / CLI│
│ daemon     │                   │   /daemon  /acp  │         │  ACP client  │
│ (this pkg) │                   └──────────────────┘         └──────────────┘
└────────────┘

Install

npm i -g @cowow/daemon

Run

# Default: dials ws://localhost:8770/daemon and proxies to the prod cowow
# UI's MCP endpoint at https://cowow-ui-….run.app/api/sse.
cowow-daemon

# Pin the daemon to a specific cowow project (clients connect with the
# same `?projectId=…` to be routed to this daemon):
cowow-daemon --project-id=acme

# Point at a different proxy / MCP backend:
ACP_PROXY_URL=wss://acp.example.com/daemon \
MCP_BASE_URL=https://cowow.example.com \
  cowow-daemon

Auth

The daemon spawns the bundled claude binary, which reads ~/.claude/ for OAuth credentials. Run claude login once on the host before starting the daemon. Alternatively set ANTHROPIC_API_KEY to bypass OAuth.

Config

| Var / flag | Default | Notes | | --- | --- | --- | | --project-id <slug> / COWOW_PROJECT_ID | empty → default slot on the proxy | Pin the daemon to one project; the proxy keeps at most one daemon per project. | | MCP_BASE_URL | https://cowow-ui-513743209269.europe-west1.run.app | Cowow backend origin. The daemon hits /api/sse[/<project>] here for MCP, and (by default) derives the ACP proxy URL from this same origin. | | ACP_PROXY_URL | derived from MCP_BASE_URL (http(s) → ws(s), /daemon appended) | Outbound WS the daemon dials. Override only if your proxy lives on a different host than the backend. | | ANTHROPIC_API_KEY | unset | Overrides ~/.claude OAuth. | | ACP_SESSION_CWD | $HOME | Working dir handed to every Claude session. | | DEBUG | unset | Verbose logs. |

License

MIT