Daemion docs

How do I get Daemion running?

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

Daemion currently relies on your local Claude CLI session for one of its main runtime paths. If your CLI is logged in, you’re ready to start.

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. Daemion reuses that local session — there is no separate Daemion cloud login.
Q Do I need extra memory infrastructure?
Not for basic use. Daemion already ships with a local knowledge substrate: compiled wiki pages, raw captured material, and searchable history. You can go quite far without adding 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 work, manages your threads, and helps you navigate the system.
  • 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 surfaces, and WebSocket streaming. Fully programmable.

What’s next?