106 lines
5.4 KiB
Markdown
106 lines
5.4 KiB
Markdown
---
|
|
title: Paseo Daemon
|
|
type: system
|
|
status: active
|
|
created: 2026-10-11
|
|
updated: 2026-11-04
|
|
verified_on: 2026-11-04
|
|
review_after: 2026-11-11
|
|
confidence: high
|
|
tags: [system, paseo, coding-agent, ct460, systemd]
|
|
sources: [live-systemctl-user, live-ps, live-paseo-config, live-session-20261010]
|
|
---
|
|
|
|
# Paseo Daemon (CT460)
|
|
|
|
Paseo is a **coding-agent orchestrator with a browser terminal workspace**. It runs on
|
|
CT460 (`hermes`), hosts terminal sessions against repositories under `/home/hermes`,
|
|
and brokers turns to external coding agents — Claude Code, Codex, Cline, OpenCode, and
|
|
Hermes itself via ACP.
|
|
|
|
- Local: `http://127.0.0.1:6767`
|
|
- Tailnet: `http://100.118.5.51:6767` (CT460's own tailnet IP)
|
|
|
|
> ⚠ **Corrected 2026-11-04.** The old tailnet URL `https://hermes.kangaroo-eel.ts.net:6767` does not work —
|
|
> **`https://` on port 6767 fails outright** (`curl` → exit code 7 / `http_code=000`; the daemon speaks **plain
|
|
> HTTP**, not TLS). The hostname `hermes.kangaroo-eel.ts.net` also resolves to **127.0.1.1 locally** (it is bound
|
|
> to the loopback on this host), so use the tailnet IP for a live check from elsewhere.
|
|
|
|
**This page documents the CT460 instance only.** Two more Paseo daemons exist and are easy to confuse with it:
|
|
**CT465** (`qwenpaw`, `pve`) runs a **system** unit `paseo.service` and **CT1261** (`m93p`, tailnet node `paseo`
|
|
at `100.72.188.93`) runs another **system** unit `paseo.service` — both on `:6767`. CT460's daemon is the
|
|
**user** unit `paseo-daemon.service`. The CT460 and CT465 instances answer **HTTP 404** on `/` (alive, but `/` is
|
|
not a route); only the CT1261 instance answers **HTTP 200** on `/`. All three answer **`/api/health` → 200**.
|
|
|
|
The daemon spawns provider processes on demand; a live example is
|
|
`opencode serve --port 42021` running as a child of the unit.
|
|
|
|
## State (re-verified 2026-11-04 04:0x AWST)
|
|
|
|
| Item | Value |
|
|
|---|---|
|
|
| Unit | `paseo-daemon.service` — **user** unit, `enabled` |
|
|
| Unit file | `/home/hermes/.config/systemd/user/paseo-daemon.service` |
|
|
| State | `active (running)` since **2026-11-02 18:11:04 AWST** |
|
|
| Daemon version | **0.14.0** (npm-global; was 0.11.2 on 2026-10-11) |
|
|
| Main PID | `953309` (`node --disable-warning=DEP0040 /home/hermes/.npm-global/bin/paseo daemon run`) |
|
|
| Listen | `0.0.0.0:6767` — `/` → **404**, `/api/health` → **200** |
|
|
| Binary used by the unit | `/home/hermes/.npm-global/bin/paseo` |
|
|
| Config | `/home/hermes/.paseo/config.json` (mode `0600`) |
|
|
| Logs | `/home/hermes/.paseo/<YYYYMMDD-HHMM>-NN-daemon.log` (10 MB rotation) and `journalctl --user -u paseo-daemon` |
|
|
|
|
## Maintenance
|
|
|
|
`sudo systemctl` will **not** see this unit — it belongs to the user manager:
|
|
|
|
systemctl --user status paseo-daemon
|
|
systemctl --user restart paseo-daemon
|
|
journalctl --user -u paseo-daemon -f
|
|
curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:6767/api/health # → 200
|
|
|
|
# Note: http://127.0.0.1:6767/ returns 404 on CT460 and CT465 (alive, but '/' is not a
|
|
# route). Use /api/health to test liveness, not '/'.
|
|
|
|
Upgrade: `npm install -g @getpaseo/cli@latest`, then restart the unit. **The daemon keeps
|
|
running the old version until the unit restarts.**
|
|
|
|
## Why `ExecStart` uses `daemon run`, not `daemon start`
|
|
|
|
`paseo daemon start` daemonises and returns immediately, so the foreground process exits
|
|
`0`. Under `Type=simple` + `Restart=always` systemd reads that as a clean exit and
|
|
restart-loops the service (the flapping observed during the 2026-10-10 repair).
|
|
`paseo daemon run` stays in the foreground and is the correct supervised command.
|
|
|
|
The unit's `PATH` must include both `/home/hermes/.npm-global/bin` and `~/.local/bin`:
|
|
agent CLIs the daemon shells out to are resolved through the *unit's* environment, not an
|
|
interactive shell's.
|
|
|
|
## Known pitfalls
|
|
|
|
- **The `paseo` on `PATH` is not the daemon's version.** `/usr/bin/paseo` reports
|
|
**0.7.2** while the unit runs the npm-global **0.14.0** (verified 2026-11-04; it was 0.11.2 on
|
|
2026-10-11). `paseo --version` therefore tells you nothing about what the daemon is
|
|
running — read the unit's `ExecStart`, or the `daemonVersion` field in the daemon log.
|
|
- **A truncated agent binary looks like a provider fault.** A partly-written `cline`
|
|
binary (107 KB ELF instead of a full ~3 MB) made that one provider fail while every
|
|
other provider worked. Check binary size before chasing provider config; reinstalling
|
|
to 3.0.70 fixed it.
|
|
- **Hermes as a Paseo provider needs the ACP extra** — `hermes pm install --extra acp`
|
|
before the Hermes provider will load (its check reports `Hermes ACP check OK` once
|
|
installed).
|
|
- **Config edits need a restart.** `baseUrl`/CORS changes in `~/.paseo/config.json` only
|
|
take effect after `systemctl --user restart paseo-daemon`. Backups are kept beside the
|
|
config (`config.json.bak-20261010-corsfix`, `config.json.bak-20260809-codex-fix`).
|
|
- **Cosmetic CLI error while the daemon is healthy (unresolved 2026-10-10).** When a
|
|
`daemon.get_status.request` takes ~2.2 s the CLI prints
|
|
`daemon detail request to 0.0.0.0:6767 failed` even though `127.0.0.1:6767` returns
|
|
HTTP 200. Verify with the health checks above before treating a single such line as an
|
|
outage.
|
|
- **Pairing payloads are credentials.** The `#offer=…` URL and `~/.paseo/daemon-keypair.json`
|
|
carry the daemon key — never paste them into the wiki or a shared channel.
|
|
|
|
## Related
|
|
- [[systems/hermes-agent]]
|
|
- [[systems/terminal-backend]]
|
|
- [[infrastructure/network-map]]
|