用途:当智能体需要安装、引导、配置、启动、检查、运行或排查 Looper(looper CLI、looperd 守护进程,或 ~/.looper 下的文件)时使用。也覆盖 webhook 模式的完整生命周期,包括启用、安装或校验 gh webhook 扩展、确认转发器健康、诊断降级运行时、用 looper webhook cleanup 清理过期 GitHub CLI hooks,以及判断何时需要重启守护进程。
主要能力:Looper 是本地守护进程 looperd,轮询 GitHub 并在各自 git worktree 中运行四种带标签门控的代理循环——Planner(looper:plan 议题,产出 looper:spec-reviewing 规格 PR)、Reviewer(被请求评审的 PR 及 looper:spec-reviewing 后续,通过后升级为 looper:spec-ready)、Fixer(本人作者的非草稿 PR 中有可处理线程)、Worker(looper:worker-ready 议题或 looper:spec-ready PR,实现直至检查通过)。所有触发字段按逻辑与组合,空标签列表表示无标签约束,可按角色和项目自定义。
使用方式:手动循环即使 autoDiscovery=false 也始终可用,如 looper plan --project <id> --issue <num>、looper review <owner>/<repo>#<pr> [--loop]、looper work --project <id> --issue <num>、looper loop start --type fixer --pr <owner>/<repo>#<pr>。一次性安装先做只读预检:仅支持 macOS(darwin-arm64)与 Linux(linux-amd64);检查 git、gh、gh auth status,必要时 brew install git gh;再检测已装代理 CLI(claude、codex、opencode、agent、grok、pi、omp)并让用户选择,随后安装 CLI:curl -fsSL https://raw.githubusercontent.com/nexu-io/looper/main/scripts/install.sh | sh,再 looper bootstrap --yes --project-path "$REPO" --agent-vendor "<vendor>"。验证用 looper status、looper daemon status、looper daemon logs --startup、looper config show、looper project list。守护进程运行时会监视配置源,热安全策略变更(含 agent.vendor)对发布后的声明生效而无需重启;切换或清空已配置 vendor 需空 agent.params 及配套模型变更。
限制:不支持直接开发 Looper 代码库(Go 源码在 cmd/、internal/、pkg/),应遵循 AGENTS.md。不支持 Windows。无 token 认证时配置 PATCH 要求直接 loopback 对等与 Host 授权并拒绝代理转发头。Dashboard 序列化会规范化注释与词法顺序,并拒绝符号链接配置路径。Grok Build、Pi、omp 不支持守护进程原生恢复与交互式 looper resume 接管。验证需汇报上述命令结果,健康时不要重启守护进程。