Documentation Index¶
Complete reference for all little-loops documentation.
Quick Start¶
New to little-loops? Start here: - Getting Started Guide - Mental model, first workflow, and when to escalate - README - Installation, quick start, and configuration - Command Reference - All available slash commands - Troubleshooting - Common issues and solutions
User Documentation¶
Documentation for using little-loops in your projects.
Codex CLI¶
- Codex CLI Overview - What works, what is deferred, and where to start
- Getting Started with Codex - Install, trust prompt, skill discovery, first-run verification
- Codex Usage - Orchestration CLIs, skill invocation, opt-in pre_tool_use, current limitations
Reference¶
- Configuration Reference - Full config options, variable substitution, and command overrides
- Command Reference - Complete reference for all slash commands with usage examples
- CLI Reference - All
ll-CLI tools with flags and examples - Output Styling Reference - Terminal output formatting and styling conventions
- Troubleshooting - Common issues, diagnostic commands, and solutions
- Session Handoff - Context management and session continuation guide
- Issue Management Guide - End-to-end issue workflow: discovery, refinement, validation, and implementation
- Sprint Guide - Sprint creation, wave execution, dependency ordering, file contention, and resume
- Loops Guide - Loop creation, FSM YAML, built-in loops, and walkthrough
- Automatic Harnessing Guide - Harness loop quality pipeline: multi-stage evaluation, retries, and wizard setup
- Examples Mining Guide - Co-evolutionary examples mining with apo-textgrad for continuously improving prompts
- Workflow Analysis Guide - Discover automation opportunities from message history using ll-workflows, analyze-workflows, and workflow-automation-proposer
- Issue Template Guide - Issue file structure, sections, and template v2.0 reference
Developer Documentation¶
Documentation for contributing to and developing little-loops.
- Contributing Guide - Development setup, guidelines, and workflow
- Architecture Overview - System design, component relationships, and diagrams
- API Reference - Python module documentation with detailed class and method references
- Event Schema Reference - All LLEvent types plus hook intent types (
LLHookEvent,LLHookResult), wire format, and machine-readable JSON schemas — primary reference for extension authors and external consumers - Write a Hook - Authoring guide for
LLHookIntentExtension: the Protocol, adapter flow, and pure-function + subprocess testing patterns - Testing Guide - Testing patterns, conventions, and best practices
- E2E Testing - End-to-end testing guide for CLI workflows
Advanced Topics¶
Deep dives into specific systems and internals.
- FSM Loop System Design - Internal FSM architecture, schema, evaluators, and compiler details
- Merge Coordinator - Sophisticated merge coordination for parallel processing
Need help? See the Troubleshooting Guide or check Getting Help section.