Skip to content

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

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, and walkthrough
  • Built-in Loops Reference - Full catalog of built-in loops, APO loops, and fragment libraries
  • Policy Router Guide - Score-driven decision-table routing with lib/policy-router and visual editing via ll-loop edit-routes
  • Learning Tests Guide - Verify external APIs and SDKs via the Feathers Learning Test lifecycle and the .ll/learning-tests/ registry
  • 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
  • Decisions Log Guide - Record decisions and required rules, generate them from history, and sync active rules into ll.local.md
  • History & Session Guide - Long-term observability via .ll/history.db: what ran, what changed, what was corrected
  • Built-in Hooks Guide - Every hook little-loops ships, what it does automatically, and the config keys that turn each on or off
  • 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.

Need help? See the Troubleshooting Guide or check Getting Help section.