looper-looper
Looper
Use this skill when an agent needs to install, configure, start, check, operate, or troubleshoot Looper (looper CLI, looperd daemon, or files under ~/.looper).
It also covers the full webhook-mode lifecycle — turning it on, installing or validating the gh webhook extension, confirming forwarders are healthy, diagnosing a degraded runtime, clearing stale GitHub CLI hooks with looper webhook cleanup, and judging when a daemon restart is actually needed.
When NOT to use this skill: developing on the Looper codebase itself (Go sources at cmd/, internal/, pkg/). For that, follow AGENTS.md and standard Go tooling.
Looper in one paragraph
Looper is a local daemon (looperd) that polls GitHub and runs four agent loops in their own git worktrees. Each loop is gated by GitHub labels:
| Role | Default discovery | Hands off via |
|---|---|---|
| 🧭 Planner | Open issues with looper:plan, assigned to current user |
Opens spec PR labeled looper:spec-reviewing |
| 🔍 Reviewer | PRs where current user is review-requested, plus looper:spec-reviewing follow-up |
A clean review on a looper:spec-reviewing PR promotes it to looper:spec-ready |
| 🔧 Fixer | Open non-draft PRs authored by current user with actionable threads | Pushes fixes; reviewer re-runs |
| 🚢 Worker | Open issues with looper:worker-ready (assigned), or PRs labeled looper:spec-ready |
Implements on the same PR until checks pass |