# Daemon Status

> Show daemon health, active sessions, task queue, and subsystem status

- Skill: `jmagly-ai-writing-guide/daemon-status` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add jmagly-ai-writing-guide/daemon-status`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jmagly-ai-writing-guide/daemon-status/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: jmagly (https://skillmd.com/u/jmagly-ai-writing-guide)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/jmagly-ai-writing-guide/daemon-status

---


# Daemon Status Skill

You detect when users want to check the AIWG daemon's health and operational status, then gather and present the information.

## Trigger Patterns

| Pattern | Example | Action |
|---------|---------|--------|
| `daemon status` | "daemon status" | Full status report |
| `daemon health` | "check daemon health" | Health-focused report |
| `is the daemon running` | "is the daemon running?" | Quick running/stopped check |
| `what's the daemon doing` | "what's the daemon doing right now?" | Active task focus |
| `show daemon` | "show me the daemon" | Full status report |

## Information Gathered

### 1. Process Status

```bash
# Check if daemon is running
cat .aiwg/daemon/daemon.pid 2>/dev/null
ps -p $(cat .aiwg/daemon/daemon.pid) 2>/dev/null
```

Report: running/stopped, PID, uptime

### 2. Active Sessions

```bash
# Check active agent sessions
ls .aiwg/daemon/sessions/ 2>/dev/null
```

Report: count, age, task descriptions

### 3. Task Queue

```bash
# Check queued tasks
cat .aiwg/daemon/queue.json 2>/dev/null
```

Report: pending count, active count, completed (last hour)

### 4. Subsystem Health

| Subsystem | Check | Status |
|-----------|-------|--------|
| File watcher | `.aiwg/daemon/watcher.pid` | running/stopped |
| Scheduler | `.aiwg/daemon/scheduler.pid` | running/stopped |
| IPC socket | `.aiwg/daemon/aiwg.sock` | listening/down |
| Messaging | `.aiwg/daemon/adapters/` | connected/disconnected |

### 5. Recent Activity

```bash
# Last 5 completed tasks
tail -5 .aiwg/daemon/activity.log 2>/dev/null
```

## Output Format

```
Daemon Status
─────────────────────────────────────
Status:     Running (PID 12345, uptime 2h 15m)
Sessions:   1 active, 0 queued
Tasks:      3 completed (last hour), 1 active

Subsystems:
  File watcher:  running
  Scheduler:     running (next: health-check in 12m)
  IPC socket:    listening
  Messaging:     Slack (connected), Discord (disconnected)

Active Task:
  "Fix auth timeout in user service" — cycle 3/6, started 8m ago

Recent:
  14:32  Completed: "Update README badges"
  14:15  Completed: "Run lint cleanup"
  13:50  Completed: "Sync issue #42"
─────────────────────────────────────
```

## Fallback When Daemon Not Running

```
Daemon is not running.

Start it with: aiwg daemon start

Last run: 2026-03-25 (2 days ago)
Last shutdown: clean (SIGTERM)
```

## References

- @$AIWG_ROOT/docs/daemon-guide.md — Daemon architecture and operations
- @$AIWG_ROOT/tools/daemon/daemon-main.mjs — Daemon implementation
- @$AIWG_ROOT/tools/ralph-external/daemon-supervisor.mjs — Agent supervisor

