ctx-loop

name	ctx-loop
description	Generate a shell script for running AI tools in autonomous iteration loops. Use when setting up unattended iteration, headless agent runs, or CI-driven AI workflows.

Generate a ready-to-use autonomous loop shell script.

Before Generating

1. Check for existing loop script: look for loop.sh in the project root; confirm before overwriting
2. Verify PROMPT.md exists: the generated script defaults to reading PROMPT.md; if missing, ask the user what prompt file to use
3. Verify the context directory exists: the loop pattern depends on persistent context; run ctx init first if needed

When to Use

• When setting up a project for autonomous iteration
• When the user wants to run unattended AI development
• When switching AI tools (e.g., Claude to Aider) and need a new loop script
• When customizing loop parameters (max iterations, completion signal, prompt file)

When NOT to Use

• For interactive pair-programming sessions (just use the AI tool directly)
• When the user already has a working loop script and has not asked for changes
• When the project lacks a context directory and PROMPT.md (set those up first with ctx init --ralph)

Usage Examples

/ctx-loop
/ctx-loop --tool aider
/ctx-loop --prompt TASKS.md --max-iterations 10
/ctx-loop --completion SYSTEM_BLOCKED --output my-loop.sh

Flags

Flag	Short	Default	Purpose
--prompt