⚙️ Background Daemons

/core-features/background-daemons

V3 Node.js Worker Daemon (Recommended)

Cross-platform TypeScript-based daemon service with auto-scheduling:

Worker	Interval	Priority	Description
`map`	5min	normal	Codebase structure mapping
`audit`	10min	critical	Security vulnerability scanning
`optimize`	15min	high	Performance optimization
`consolidate`	30min	low	Memory consolidation
`testgaps`	20min	normal	Test coverage analysis

Commands:

bash

npx ruflo@latest daemon start

npx ruflo@latest daemon status

npx ruflo@latest daemon trigger map

npx ruflo@latest daemon enable map audit optimize

npx ruflo@latest daemon stop

Daemon Status Output:

+-- Worker Daemon ---+
| Status: ● RUNNING  |
| PID: 12345         |
| Workers Enabled: 5 |
| Max Concurrent: 3  |
+--------------------+

Worker Status
+-------------+----+----------+------+---------+----------+----------+
| Worker      | On | Status   | Runs | Success | Last Run | Next Run |
+-------------+----+----------+------+---------+----------+----------+
| map         | ✓  | idle     | 12   | 100%    | 2m ago   | in 3m    |
| audit       | ✓  | idle     | 6    | 100%    | 5m ago   | in 5m    |
| optimize    | ✓  | running  | 4    | 100%    | now      | -        |
| consolidate | ✓  | idle     | 2    | 100%    | 15m ago  | in 15m   |
| testgaps    | ✓  | idle     | 3    | 100%    | 8m ago   | in 12m   |
+-------------+----+----------+------+---------+----------+----------+

Legacy Shell Daemons (V2)

Shell-based daemons for monitoring (Linux/macOS only):

Daemon	Interval	Purpose	Output
Swarm Monitor	3s	Process detection, agent counting	`swarm-activity.json`
Metrics Daemon	30s	V3 progress sync, SQLite metrics	`metrics.db`

Commands:

bash

.claude/helpers/daemon-manager.sh start 3 5

.claude/helpers/daemon-manager.sh status

.claude/helpers/daemon-manager.sh stop

Worker Manager (7 Scheduled Workers)

Worker	Interval	Purpose
`perf`	5 min	Performance benchmarks
`health`	5 min	Disk, memory, CPU monitoring
`patterns`	15 min	Pattern dedup & pruning
`ddd`	10 min	DDD progress tracking
`adr`	15 min	ADR compliance checking
`security`	30 min	Security vulnerability scans
`learning`	30 min	Learning pattern optimization

Commands:

bash

.claude/helpers/worker-manager.sh start 60

.claude/helpers/worker-manager.sh force

.claude/helpers/worker-manager.sh status

📊 V3 Statusline

⌨️ V3 CLI Commands