A multi-agent workflow orchestration CLI for AI-assisted development, enabling traceable parallel development through isolated environments and Issue persistence.
iloom (@iloom/cli) is an Issue-driven workflow system for AI-assisted development. Its core design philosophy moves AI reasoning from chat windows into Issue Trackers, making context traceable, reviewable, and shareable across teams.
The system is built around the "Loom" concept—each Loom maps to an Issue and provides a fully isolated work environment: independent Git Worktree filesystem, Neon database branch, separate environment variables, and deterministic port assignment, eliminating environment conflicts in parallel task execution.
Within a single Loom, iloom orchestrates a pipeline of specialized Agents: Enhancer expands requirements, Evaluator assesses complexity, Analyzer explores the codebase, Planner generates execution plans, and Implementer executes coding. For epic tasks, the Swarm Orchestrator launches independent parallel agent teams for each sub-issue, each autonomously completing work in isolated worktrees.
iloom itself does not perform AI inference; it acts as an orchestration layer invoking Claude CLI. Authentication is fully delegated to external tools (gh, Claude CLI, Neon CLI). Configuration follows a four-tier priority system (CLI args > local > project > global), supporting automation levels from staged approval to fully autonomous (--yolo).
Built with TypeScript (ES Module), using Commander.js, execa for process management, and zod for runtime validation. Testing uses Vitest with fast-check property-based testing. Through .iloom/package.iloom.json, arbitrary language shell scripts can be defined, supporting Rust, Python, Go, and other non-Node.js projects. Current version 0.13.5. Licensed under Business Source License 1.1, automatically converting to Apache 2.0 after 2030-04-17.
Core commands: il start creates a loom and launches the agent pipeline, il spin starts Claude in the current loom, il plan interactively plans epic tasks, il finish validates and merges, il vscode installs the VS Code extension.
VS Code extension provides Recap Panel (real-time AI decisions and risks), Loom Explorer (manage active tasks), Kanban board and dependency graph (Swarm mode).
Issue management support: GitHub (via GitHub CLI) and Linear (via @linear/sdk).