LoopTroop
LoopTroop is a free, open-source local GUI orchestrator that automates complex, multi-file coding tasks from a ticket to a pull request. It breaks work into planning, execution, and shipping stages, using LLM councils for planning, isolated worktrees for execution, and automated retry loops to ensure correctness. It is for developers who need high-correctness, long-running AI-assisted feature work.
🎬 How LoopTroop Uses LLM Councils & Ralph Loops to Automate Complex Coding Tasks (Deep dive) · LoopTroop
✨ Key features
- LLM Council planning with draft, vote, refine, verify
- Interactive interview to clarify requirements
- PRD generation with epics and user stories
- Beads methodology for atomic implementation units
- Ralph-style recovery loop with clean retries
- Isolated OpenCode worktrees for each bead
🎯 Use cases
- Automate large feature implementation from ticket to PR
- Plan complex multi-file changes with structured specs
- Run long-running coding tasks with minimal AI context rot
- Generate and execute detailed implementation plans
- Integrate with GitHub for pull request creation
📦 Installation
🧰 Requirements: Requires Node.js 24.18.1+ and npm 12.0.2+ (or other package managers), git, gh authenticated, and OpenCode with at least one configured model provider.
Quick start
curl -fsSL https://www.looptroop.ovh/install | sh
looptroop open
npm
npm install -g looptroop
npm install -g looptroop@latest # upgrade
Homebrew (macOS/Linux)
brew install looptroop-ai/tap/looptroop
brew upgrade looptroop # upgrade
Scoop (Windows)
scoop bucket add looptroop https://github.com/looptroop-ai/scoop-bucket
scoop install looptroop
scoop update looptroop # upgrade
Docker
docker pull looptroopai/looptroop:latest
🚀 Usage
After installation, run:
looptroop open
This starts LoopTroop in the background and opens the GUI. Then configure settings and models, attach a local repository with a GitHub origin, create a ticket, and start it.
⚠️ Good to know
LoopTroop is designed for slow and perfect execution, not speed; it requires OpenCode and does not install it; it may take hours for complex tasks.
❓ FAQ
What are the system requirements?
You need Node.js 24.18.1+ and npm 12.0.2+ (or another supported package manager), git, gh authenticated, and OpenCode with at least one model provider configured.
How does LoopTroop ensure code quality?
It uses context engineering to feed only minimal relevant context, LLM councils for planning, and a Ralph-style recovery loop that resets worktrees and retries with clean context on failures.
Can I use it with any package manager?
Yes, it supports npm, Homebrew, Scoop, bun, pnpm, Yarn Classic, and Docker, each with specific installation instructions.
Does LoopTroop create pull requests?
Yes, it uses OpenCode worktrees and the gh CLI to create pull requests at the end of a ticket.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.