Daemion docs

How do I get Daemion running?

~2 minutes
Prerequisites: Node.js 22+, Claude CLI (logged in)

Daemion uses the Claude Agent SDK, which authenticates through your Claude CLI session. No API keys to set — if you’re logged into the CLI, you’re ready to go.

Step 1 — Install

bash

npm install -g daemion

This installs the daemion CLI globally so you can run it from anywhere.

Step 2 — Start the gateway

bash

daemion start

You should see output like this:

text

Daemion gateway running on http://localhost:3001

Pair your phone: ┌─────────────────────────────┐ │ │ │ ▄▄▄▄▄ ▄ ▄▄▄ ▄▄▄▄▄ │ │ █ █ ██ █ █ █ █ │ │ █▄▄▄█ █▄▄█ █ █▄▄▄█ │ │ │ └─────────────────────────────┘

OTP: 847291 (expires in 10 minutes)

The QR code encodes your gateway URL and a one-time pairing token. Scan it with your phone’s camera to pair automatically.

Step 3 — Open the app

bash

cd app && npm run dev

Open http://localhost:3000 in your browser. The app connects to the local gateway at port 3001.

Common questions

Q How do I sign in?
Run claude in your terminal, then /login to authenticate with your Anthropic account. Daemion inherits that session via the Claude Agent SDK — no separate login required. See the Sign-in guide for details.
Q Do I need Neo4j or Engram?
Not for basic use. The gateway runs fine without it. Engram adds persistent knowledge graph memory across sessions, but it's optional. You can add it later without changing anything else.
Q How do I access Daemion from my phone?
Install Tailscale on both your Mac and your phone. Once connected, your gateway is reachable at your Tailscale hostname from anywhere. See the Pair a Device guide for the full walkthrough.
Q What is the gateway token?
It's a device pairing token — not user authentication. It connects your browser or phone to your local gateway. Each new device gets a fresh OTP to pair. It has nothing to do with your Anthropic account or API access.

What can go wrong

Common issues

command not found: daemion — The global install didn’t land on your PATH. Try npm install -g daemion again, or check that your npm global bin is in $PATH (npm bin -g).

EADDRINUSE :3001 — Something else is using port 3001. Stop the other process or set DAEMION_PORT=3002 before running daemion start.

claude: not authenticated — You need to log into the Claude CLI first. Run claude in your terminal, then /login. Once authenticated, restart the gateway.

What’s included out of the box

Once the gateway is running, you have:

  • Daemion agent — the main orchestration agent. Coordinates jobs, routes to the right model, manages your threads, and connects to the knowledge graph.
  • Pulse agent — self-improvement engine. Analyzes usage patterns and files proposals to improve the system. You review and approve.
  • Built-in terminal — full shell access to your machine from any paired device. Restart the gateway, tail logs, run scripts, manage files.
  • 40+ API endpoints — conversations, extensions, jobs, knowledge graph, WebSocket streaming. Fully programmable.

What’s next?