| name | daemon-operations |
| description | Use for daemon service health checks, runtime diagnostics, restart procedures, and burn-in monitoring |
Daemon Operations
When To Use
Use this skill for day-to-day daemon ops and post-deploy checks.
Service Identity
- Active service name on devbox:
pigeon-daemon.service
- Service now runs Pigeon daemon entrypoint from
packages/daemon/src/index.ts
Health Checks
systemctl status pigeon-daemon.service --no-pager
curl -s http://127.0.0.1:4731/health
systemctl status opencode-serve.service --no-pager
curl -s http://127.0.0.1:4096/global/health
Expected:
- pigeon-daemon is active/running, health returns
{"ok":true,"service":"pigeon-daemon"}
- opencode-serve is active/running, health returns
{"healthy":true,...}
Operational Logs
journalctl -u pigeon-daemon.service -n 100 --no-pager
journalctl -u opencode-serve.service -n 100 --no-pager
Look for:
- poller tick errors:
[poller] tick error: or [poller] poll failed:
- poller dispatch errors:
[poller] dispatch error (skipping ack)
- worker register/unregister success:
[poller] registerSession
- notification send failures
- launch-ingest:
session started sessionId=... directory=...
- kill-ingest:
session terminated sessionId=...
- compact-ingest:
session compacted commandId=... sessionId=...
- mcp-ingest:
enable commandId=... server=... session=... or disable commandId=...
- model-ingest:
set commandId=... model=... session=...
- session reaper:
[reaper] reaped stale session ... or [reaper] cleaned N expired session records
- dead session cleanup:
[command-ingest] removing dead session sessionId=... (connection error)
- wizard advancement:
[command-ingest] wizard advanced to step N
- media fetch failures:
Failed to fetch media from R2 in command-ingest logs
- media upload failures: silent (text notification still sends), but
uploadMedia errors appear in daemon stderr
Restart Procedure
sudo systemctl restart pigeon-daemon.service
systemctl status pigeon-daemon.service --no-pager
sudo systemctl restart opencode-serve.service
systemctl status opencode-serve.service --no-pager
Media Relay Diagnostics
If media isn't arriving in Telegram or OpenCode:
- Check worker R2 bucket exists:
npx wrangler r2 bucket list should show pigeon-media.
- Check worker deploy has MEDIA binding: deploy output should show
env.MEDIA (pigeon-media).
- Inbound (Telegram→OpenCode): daemon logs will show media fetch errors if the worker URL or API key is wrong.
- Outbound (OpenCode→Telegram): daemon uploads silently skip failures — check worker
/media/upload auth if media never appears in Telegram.
- Cron cleanup: if media disappears before delivery, check that the 24h TTL in
cleanupExpiredMedia is sufficient.
Verify
Run health + one route smoke call:
curl -s -X POST -H "Content-Type: application/json" http://127.0.0.1:4731/session-start --data '{"session_id":"ops-smoke","notify":false}'
curl -s -X DELETE http://127.0.0.1:4731/sessions/ops-smoke
