dmoliveira/ailoop

ailoop 🔁

## Run AI terminal tools in repeatable loops YAML config, durable state, task-file mode, presets/history, pause/resume, and stats for OpenCode, Codex, Claude, and more. Docs: GitHub Pages · docs/index.md By: Diego Marinho · LinkedIn Support: https://buy.stripe.com/8x200i8bSgVe3Vl3g8bfO00

ailoop is a small CLI for repeatable AI terminal loops with durable state, task-file mode, pause/resume controls, and machine-friendly output.

It is built for people who want a simple way to run AI terminal tools like OpenCode, Codex, and Claude Code in safe repeatable loops instead of brittle one-off shell snippets.

Why ailoop? 🧭

Most AI terminal workflows start as a quick while true loop, then grow messy fast.

ailoop gives you:

• ✅ repeatable loop runs
• ✅ YAML config + CLI overrides
• ✅ durable local state
• ✅ pause / resume / stop controls
• ✅ strict Markdown task-file mode
• ✅ saved presets + replayable history

• ✅ workspace-aware TUI follow-ups + prompt history
• ✅ stats, logs, and tail commands
• ✅ JSON output for automation

Quick start ⚡

Install:

uv sync

Run from this repo:

uv run ailoop init-config
uv run ailoop run "Do exactly 3 iterations." --steps 3

Or download the wheel from the latest GitHub release, then install it:

pipx install ./ai_loop-*-py3-none-any.whl
ailoop --help

Start:

ailoop init-config
ailoop run "Review the repo and iterate for 3 steps." --runner opencode --agent orchestrator --steps 3
ailoop run "Work this repo." --workspace-root . --steps 3
ailoop run "Do exactly 5 iterations." --steps 5