Loop Launcher

Configure, launch, and monitor autonomous infinity and polish loop pipelines.

1|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/htxryan/claude-code-config-profiles --skill loop-launcher-htxryan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Loop Launcher
Source: https://github.com/htxryan/claude-code-config-profiles/tree/main/.agents/skills/compound/loop-launcher
Command: npx skills add https://github.com/htxryan/claude-code-config-profiles --skill loop-launcher-htxryan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Running autonomous multi-epic implementation loops requires correctly generating scripts, launching them in detached terminal sessions, and continuously monitoring progress, stalls, and crashes — a process that is error-prone when done manually. ## Core Features & Use Cases - Script Generation: Generate infinity loop and polish loop scripts via the ca loop and ca polish CLI commands with flags for models, reviewer fleets, retry limits, and review cycles. - Detached Launching: Launch loops in GNU screen sessions (or tmux under WSL2 on Windows) with chained pipeline support for running infinity and polish loops sequentially. - Health Monitoring: Structured health-check protocol reading .loop-status.json, loop-execution.jsonl, and trace logs to detect stalls, crashes, retries, and human-required blockers, with per-epic progress tables and ETA estimates. - Use Case: After planning a set of beads epics, generate an infinity loop script, dry-run it, launch it in a screen session, then ask for a progress report showing completed epics, current epic, and anomalies. ## Quick Start Ask the assistant to generate and launch an infinity loop for your open beads epics and then report on its progress.

Frequently Asked Questions about Loop Launcher

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I launch an autonomous infinity loop for beads epics?▼

Generate the script with `ca loop --epics "id1,id2" --force`, dry-run it with `LOOP_DRY_RUN=1 bash .compound-agent/infinity-loop.sh`, then launch it detached in a screen session and record the session name in `.beads/loop-session-name`.

How do I check the progress of a running loop?▼

Read `.compound-agent/agent_logs/.loop-status.json` for the current epic and status, and `loop-execution.jsonl` for completed epics with durations. You can also attach to the live screen session or run `ca watch` for a live trace tail.

Can I run infinity loops on Windows?▼

Yes, via two paths: run the loop unmodified inside WSL2 with tmux for session management, or use the provided PowerShell reference template `infinity-loop.ps1`, which runs in the foreground only and lacks review triggers and process-tree killing.

Why does my Claude session hang or exit silently in a loop script?▼

Non-interactive Claude invocations require `--dangerously-skip-permissions --permission-mode auto --verbose`; without skip-permissions the session hangs on prompts, and without `--verbose` the stream-json output silently exits. A stale `ca` binary generating scripts without these flags is the usual cause.

How do I detect if a running loop has stalled?▼

Check the modification time of `.loop-status.json`; if it is older than five minutes, read the last lines of the active trace file twice with a 15-second gap. Identical output indicates a stall, and a `crashed` status reports exit code and line number.