little-loops logo
ll:little-loops
Autonomous Development Toolkit

Your output won't scale
if you're in every
little loop

little-loops imagines Software Engineering as the art of crafting simple machines that run themselves. A loop to discover bugs. A loop to score results. A loop to write code that feels inevitable. A loop made of these loops.

Plugin
bash
pip install little-loops
/plugin marketplace add BrennonTWilliams/little-loops
/plugin install ll@little-loops

You were promised

exponential output.

You got

babysitting chat windows.


What if...

agents worked for minutesfor hoursfor days
until done.

// designed to run without you

Loops

Wind it up. Let it run.

A loop is a small machine you define once and run forever. Describe what to check, what to fix, and when to stop — little-loops compiles it into a finite state machine and hands it to Claude. No babysitting. No streaming output to watch. Just a goal and a done condition.

Never write a disposable prompt again.

Start from a conversation, a pattern you keep repeating, or a blank slate.

bash
/ll:create-loop

Interactive wizard — answer a few questions, get a YAML loop file.

bash
/ll:loop-suggester

Mines your session history for repeated workflows and proposes loops that would automate them.

Resilience

State saves to disk after every FSM transition. Crashes, context resets, Ctrl-C — ll-loop resume picks up exactly where it stopped.

Coordination

Agents automatically hand off to new agents when context gets long. Context rot is now a 2025 problem.

Automatic Harnessing

Agents climb any mountain with the right harness

The best feedback loop is the product itself. Automatic harnessing wraps any skill, command, or MCP tool call in a layered evaluation pipeline — from fast exit-code checks to full agentic simulations where Claude uses the feature end-to-end. Generate harnesses interactively with a guided wizard or let little-loops derive them from your project.

Turn your tools into agent rules, in one command.

A harness isn't limited to running tests. It can wire together anything your project has:

Skills

Invoke any little-loops skill as an evaluation step. Refine an issue, check code quality, audit docs — then evaluate whether the skill's output actually met the bar.

MCP Tools

Call external services directly. Query a database, screenshot a page, check that a GitHub PR was created. Any MCP server you've connected becomes an evaluation gate.

CLI Commands

Any shell command that returns an exit code. Your test suite, linter, type checker, a custom validation script. If it exits 0, it passes.

Issues

Context that travels with your code.

Issues in little-loops aren't tickets in an external system. They're structured Markdown files that live in your repo — capturing root causes, integration maps, and acceptance criteria that agents need to implement correctly.

Context is the difference between a guess and a fix.

A raw “fix the login bug” prompt leads to guesswork. A well-formed issue with a root cause analysis, integration map, and implementation steps gives the agent exactly what it needs to make a correct, focused change.

Vague → vague fix
add search maybe filter by name or date?
Structured → working
## Summary
Add full-text search to the issues list with filtering
by name, priority, and date range.

## Root Cause
No search index or filter state in the issue list component.

## Integration Map
- src/components/IssueList.tsx — add search state + filter logic
- src/hooks/useIssues.ts — extend with search/filter params
- src/api/issues.ts — add query params to the list endpoint

## Acceptance Criteria
- [ ] Search returns results within 200ms
- [ ] Priority filter supports multi-select
- [ ] Empty state shown when no results match
Implement

One issue or thirty. Your call.

Refined issues go in. Committed code comes out. Choose sequential for simplicity, parallel for speed, or sprint for coordinated execution across dependency graphs.

Sequential. Predictable. Fire and forget.

Picks up every ready issue in priority order and works through them one at a time. Deterministic execution — each issue completes before the next begins. Great for auditable, reviewable batch work.

bash
ll-auto
ll-auto --max-issues 5
ll-auto --resume
Install

Three commands.

bash
# 1. Add the plugin marketplace
claude plugin marketplace add BrennonTWilliams/little-loops

# 2. Install the plugin
claude plugin install ll@little-loops

# 3. Install the CLI tools via pip
pip install little-loops
bash
# 4. Initialize for your project
/ll:init

# 5. Start scaling
/ll:audit-claude-config
/ll:scan-codebase