yan5xu/codexloom

Turn Codex threads into an organization of long-lived domain agents.

CodexLoom – 持久化的 AI-代理工作区

是什么 – CodexLoom 是一个自托管平台,通过持久的身份、个人资料和组织结构扩展了 Codex 聊天代理运行时。它允许单个 领域代理 保持稳定的 ID、名称、个人资料和主线程,这些在多个任务中持续存在,而其他代理则通过有界消息、主题和管理的工件与之通信。该系统还提供“接口代理”,将这些内部代理暴露给外部聊天工具(如 Feishu、Slack、Parall)。

核心功能

  • 长期运行的代理 – 稳定的 ID、可编辑的个人资料、持久的线程和可配置的模型设置。
  • 多表面访问 – 同一线程可从 Codex 桌面端、移动端、CodexLoom Web UI 或 loom CLI 访问,并支持实时同步。
  • 代理间消息传递 – 支持队列、发送、回复和交付状态追踪,同时保留完整历史记录。
  • 有界协作 – 用于范围协作的主题、“需要你”提示以获取人类决策,以及受管理的工件交接。
  • 团队组织 – 可拖拽的地图用于组织(责任层级)、协作(跨领域链接)、活动(证据)以及所有代理的目录。
  • 受控的外部交付 – 接口代理将代理映射到外部 IM 会话,强制执行会话成员政策,并保持身份/授权边界。
  • 运维工具 – 计划、外部触发器、运行时检查、按需备份、优雅重启和使用仪表板(令牌、上下文、缓存、模型)。

目标用户 – 希望多个专用代理持续运行、将其集成到已使用的聊天工具中,并在任务间保持代理知识的高级单人用户或一人公司所有者。企业多租户功能目前并非主要重点。

快速开始

# 前提:安装 `codex` CLI 并使用 ChatGPT 账户登录
make release               # 构建二进制文件
./bin/codex-loom           # 启动本地服务器(http://localhost:4870)

然后可以通过 Web UI 或 CLI 创建代理,设置其个人资料,并发送第一条消息:

./bin/loom agent create research --cwd /path/to/repo
./bin/loom profile set research \
  --identity "Long‑term researcher" \
  --domain "Research the product ecosystem" \
  --scope "Answer questions, preserve conclusions"
./bin/loom thread send research "Establish a baseline for this domain"

社区与文档 – 提供 Feishu 社区用于讨论。完整文档(所有者指南、API 规范、集成笔记、CLI 参考、架构手册等)位于 docs/ 目录下。

许可证与状态 – 源代码开放,采用 Elastic License 2.0(非 OSI 批准的开源)。项目为 本地优先、自托管且处于积极开发中;远程功能依赖于可能变更的实验性 Codex API。


以上所有信息均直接取自仓库的 README,未作额外声明。

相关