loom

让 AI 代理自动循环交付，少人工盯梢

开源 free 自动化工作流

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1239

维护状态活跃

是否开源是

定价模式 free

项目预览

项目数据

分类自动化工作流

开发团队valkor-ai

所属国家

官网地址

GitHubhttps://github.com/valkor-ai/loom

定价模式free

价格说明开源免费，定价信息待确认

访问状态

是否开源是

开源协议Apache-2.0

主要语言Rust

技术栈/模型

GitHub 星标★ 1239

30天Star增速

HF 下载量

上线时间2026-06-09 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-12

浏览次数0

项目介绍

Loom 是一个用 Rust 编写的智能体软件交付工作流引擎，核心思路是把 AI 代理的交付过程抽象成可循环、可编排的工程化流水线。它解决的是当前 AI 编码代理普遍存在的“一次性执行、缺乏闭环反馈”问题：代理完成任务后往往不会自动验证结果、修复失败或迭代改进，导致交付质量依赖人工反复干预。Loom 通过定义循环（loop）结构，让代理在计划、执行、验证、修正之间自动流转，并支持把多个代理或工具节点串成端到端交付流程。其核心能力包括循环编排、状态管理、失败重试与结果校验，适合需要让 AI 代理稳定完成多步骤软件任务的团队。项目用 Rust 实现，强调性能与可靠性，目前处于成长阶段，社区规模较小但方向明确。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：命令行工具 8 步

环境要求

一台 macOS / Linux 或 Windows 机器（安装脚本会自动识别 OS 与 CPU）
已安装 Codex、Claude Code 或 OpenCode 中至少一个编码代理
curl 与 bash（macOS/Linux），或 PowerShell（Windows）
能访问 GitHub Releases 下载发布包（安装器会校验 .sha256 资产）
仅在本地源码构建模式下才需要 Rust 工具链（README 未给出具体版本要求）

安装与启动步骤

1确认目标代理

Loom 是给编码代理用的交付插件，支持 Codex、Claude Code、OpenCode，先确定你本机用的是哪一个。
2Linux/macOS 一键安装

同一条命令把 --agent 换成 claude-code、opencode 或 all 即可安装到对应代理或全部代理。
```
curl -fsSL https://github.com/valkor-ai/loom/releases/latest/download/install.sh | bash -s -- --agent codex
```
3Windows 安装

先下载 install.ps1，再用 -Agent 参数指定目标代理，可选值为 codex、claude-code、opencode、all。
```
Invoke-WebRequest https://github.com/valkor-ai/loom/releases/latest/download/install.ps1 -OutFile install.ps1
.install.ps1 -Agent codex
```
4源码本地构建安装

在仓库 checkout 目录中使用同一安装器的本地构建模式，会编译 Rust MCP server 与 setup 二进制并走完整安装流程。
```
./install.sh --agent codex --local-build
```
5重开代理会话

安装或更新插件后，需在目标项目里新开一个代理会话，让刷新后的 MCP 注册与插件文件被加载。
6验证安装状态

在编码代理里执行 status 做只读冒烟检查，返回 STATE_NOT_INITIALIZED 也属正常，说明命令可用且尚未开始交付。
```
@loom status
/loom status
```
7运行交付流程

用 build 发起新交付，用 continue 恢复或推进中断的交付，review 复核改动，deploy 验证本地预览。
```
@loom build Add a team settings page
@loom continue
@loom review
@loom deploy
```
8卸载与清理

按代理卸载插件，--all 移除本机全部 Loom 代理插件，purge 进一步删除用户级运行时与知识索引。
```
~/.loom/bin/loom-setup uninstall --agent codex
~/.loom/bin/loom-setup uninstall --all
~/.loom/bin/loom-setup purge
```

关键配置

配置项	必填	说明	示例
`--agent`	是	指定为哪个编码代理安装 Loom 插件	`codex`
`-Agent`	否	Windows PowerShell 安装脚本中对应的代理参数	`claude-code`
`--local-build`	否	从仓库 checkout 本地构建并安装，用于本地修复后验证	`./install.sh --agent codex --local-build`

如何确认成功

在编码代理里执行 @loom status（Codex）或 /loom status（Claude Code、OpenCode），返回 STATE_NOT_INITIALIZED 即说明插件命令已生效。

常见问题

Q：status 返回 STATE_NOT_INITIALIZED 是安装失败吗？

A：不是。这个命令是只读的，在尚未使用过 Loom 的项目里该结果表示插件命令可用、还没有开始任何交付，是有效的冒烟检查结果。

Q：需要手动初始化 .loom/ 或手动启动 MCP server 吗？

A：都不需要。从代理里发起 @loom build 或 /loom build 时会自动初始化项目级交付状态；Rust MCP server 由代理的 MCP 注册启动，用户不手动运行。

Q：如何升级到新版本？

A：重新执行同一个安装命令即可完成升级。安装器会先移除 Loom 自有的旧版 CLI 插件产物，再安装 MCP 运行时。

Q：安装器中途停下并提示有文件需要手动删除怎么办？

A：说明它发现了无法证明属于 Loom 的文件。按提示手动删除这些文件后重新执行安装命令，安装器不会覆盖用户文件。

Q：卸载后项目里的交付状态会丢吗？

A：uninstall 会保留项目本地的 .loom/ 交付状态；purge 范围更大，会删除用户级运行时与知识索引，只在确定要彻底清理时使用。

注意事项

安装或更新代理插件后必须新开一个代理会话，否则刷新后的 MCP 注册与插件文件不会加载。
在 Codex 中使用 @loom，在 Claude Code 与 OpenCode 中使用 /loom，日常操作都通过代理的命令界面完成。
Agent 插件会自动设置 Loom 的路由环境，正常使用不必手动配置。
本地构建模式只在修复 bug 后使用，用于同时验证安装器、包布局、MCP 注册与插件刷新。

核心亮点

用 Rust 实现循环编排引擎，性能与并发处理能力有保障
把代理交付抽象为可复用的 loop 结构，支持验证与修正闭环
面向软件交付全流程，而非单点代码生成，工程化程度较高

不足之处

项目较新、星标仅千余，生态与插件丰富度有限
文档和示例可能不够完善，上手需要一定学习成本

适用场景

让 AI 代理自动完成编码、测试、修复的迭代循环
编排多个代理协作完成端到端软件交付任务
为内部 AI 工作流平台提供可复用的循环执行引擎

替代项目

LangGraph、CrewAI

上一篇：AVA-AI-Voice-Agent-for-Asterisk

下一篇：WinShun