Agent Skills › winstonkoh87/Athena-Public › daemon-loop

daemon-loop

GitHub

将工作流转化为持久化后台守护进程，支持定时自动执行。提供Cron、会话内循环及异步集成三种架构，适用于记忆同步、代码审查等场景，具备安全限制与状态追踪功能。

examples/skills/workflow/daemon-loop/SKILL.md winstonkoh87/Athena-Public

Trigger Scenarios

需要定期自动执行任务（如记忆同步、代码审查）用户请求在后台持续运行某个工作流

Install

npx skills add winstonkoh87/Athena-Public --skill daemon-loop -g -y

More Options

Non-standard path

npx skills add https://github.com/winstonkoh87/Athena-Public/tree/main/examples/skills/workflow/daemon-loop -g -y

Use without installing

npx skills use winstonkoh87/Athena-Public@daemon-loop

指定 Agent (Claude Code)

npx skills add winstonkoh87/Athena-Public --skill daemon-loop -a claude-code -g -y

安装 repo 全部 skill

npx skills add winstonkoh87/Athena-Public --all -g -y

预览 repo 内 skill

npx skills add winstonkoh87/Athena-Public --list

SKILL.md

Frontmatter

{
    "name": "daemon-loop",
    "vibe": "Infrastructure that works while you sleep.",
    "model": "default",
    "auto-invoke": false,
    "description": "Autonomous recurring agent tasks — converts workflows into persistent background daemons that run on intervals. Stolen from Boris Cherny's Claude Code `\/loop` pattern (2026-03-31).",
    "context_trigger": "loop, daemon, background, autonomous, recurring, schedule, cron"
}

Daemon Loop — Autonomous Agent Infrastructure

Source: Boris Cherny (Claude Code creator), X thread 2026-03-30 (CS-560) Pattern: "Turn workflows into skills, then loop them."

Core Concept

Traditional Athena workflows are pull-based — user triggers /start, /audit, /reindex manually. Daemon loops are push-based — they run autonomously at set intervals without user invocation.

This is the difference between a tool and infrastructure.

When to Use

Use Case	Interval	Workflow
Memory consolidation (dream pass)	24h (3-gate)	`/dream`
Memory sync to Supabase	60m	`/reindex`
Workspace hygiene + dead file pruning	24h	`/needful`
PR/commit review (if git-active)	5m	`/check`
Stale context detection (`.context/` drift)	12h	`/audit` (lightweight)
Client delivery queue check	30m	Custom scan

Architecture

Option A: Cron + Headless Agent (Current-Compatible)

For environments where the agent platform supports CLI invocation:

# Example: reindex every hour
0 * * * * cd ./project && claude --bare -p "/reindex" 2>&1 >> .agent/temp/daemon.log

# Example: workspace hygiene daily at 4am
0 4 * * * cd ./project && claude --bare -p "/needful" 2>&1 >> .agent/temp/daemon.log

Key: --bare flag skips full context loading for speed. Only load what the specific daemon needs.

Option B: In-Session Loop (Manual Trigger)

When cron is unavailable, run a daemon within an active session:

User: "Loop /reindex every 60 minutes for the next 8 hours"
Agent: [Executes /reindex, sleeps 60m, repeats 8x]

Constraint: Requires an active session. Prefer Option A for true autonomy.

Option C: Async-Dev Integration

Combine with /async-dev (Sleeper Agent Protocol):

User sets up daemon tasks before sleeping
Agent executes loop overnight
Morning: user reads STATUS.md for results

Daemon Registration

Track active daemons in .agent/temp/daemons.json:

{
  "daemons": [
    {
      "name": "memory-sync",
      "workflow": "/reindex",
      "interval": "60m",
      "last_run": "2026-03-31T01:00:00+08:00",
      "status": "active",
      "bare": true
    }
  ]
}

Safety Rules

CAN: Run read-only or idempotent workflows (reindex, audit, check, dream)
CAN: Write to .agent/temp/ and .context/ directories
CANNOT: Commit, push, or mutate source code without explicit user pre-authorization
CANNOT: Run workflows that require interactive user input
CANNOT: Exceed 8-hour autonomous window without checkpoint
BLOCKING BUDGET: Any single daemon action that would block for >15 seconds must be deferred (stolen from KAIROS)

Boris Cherny's Live Examples (Reference)

His Daemon	Interval	What It Does
`/babysit`	5m	Code review, rebase, shepherd PRs to production
`/slack-feedback`	30m	Create PRs from Slack feedback automatically
`/post-merge-sweeper`	on-event	Catch missed code review comments post-merge
`/pr-pruner`	1h	Close stale PRs