面向 AI 辅助开发的多智能体工作流编排 CLI 工具,通过隔离环境与 Issue 持久化实现可追溯的并行开发。
iloom(@iloom/cli)是一个以 Issue 驱动的 AI 辅助开发工作流系统。其核心设计理念是将 AI 推理过程从聊天窗口迁移到 Issue Tracker 中,使上下文可追溯、可审查、可团队共享。
系统围绕 "Loom" 概念构建——每个 Loom 对应一个 Issue,提供完全隔离的工作环境:独立 Git Worktree 文件系统、Neon 数据库分支、独立环境变量与确定性端口分配,彻底解决多任务并行时的环境冲突问题。
在单个 Loom 内,iloom 编排一条专业化 Agent 管道:Enhancer 扩展需求、Evaluator 评估复杂度、Analyzer 探索代码库、Planner 生成执行计划、Implementer 执行编码。对于史诗级任务,Swarm Orchestrator 可为每个子 Issue 启动独立的并行 agent 团队,各自在隔离 worktree 中自主完成。
iloom 自身不执行 AI 推理,而是作为编排层调用 Claude CLI。认证完全委托给 gh、Claude CLI、Neon CLI 等外部工具。配置采用四层优先级体系(CLI 参数 > 本地 > 项目 > 全局),支持从逐阶段审批到全自动(--yolo)的多种自动化层级。
项目基于 TypeScript(ES Module)构建,使用 Commander.js 框架、execa 进程管理、zod 运行时校验,测试采用 Vitest + fast-check 属性测试。通过 .iloom/package.iloom.json 可定义任意语言的 shell 脚本,支持 Rust、Python、Go 等非 Node.js 项目。当前版本 0.13.5,采用 Business Source License 1.1 授权,2030-04-17 后自动转为 Apache 2.0。
核心命令:il start 创建 loom 并启动 agent 管道、il spin 在当前 loom 中启动 Claude、il plan 交互式规划史诗任务、il finish 验证并合并、il vscode 安装 VS Code 扩展。
VS Code 扩展提供 Recap Panel(实时查看 AI 决策与风险)、Loom Explorer(管理活跃任务)、Kanban 看板与依赖图(Swarm 模式)。
Issue 管理支持:GitHub(via GitHub CLI)和 Linear(via @linear/sdk)。