compozy 是什么?

CompozyOS 是本地优先的 AI agent 运行层。它用常驻 daemon 保存 session、task、Loop、memory 和审批状态,再让 Claude Code、OpenClaw、Hermes 等 ACP 兼容 CLI 在同一工作区内持续执行;浏览器、CLI、HTTP/SSE、UDS 和 MCP 读取同一份状态。

⭐ 2,141 Stars 🍴 108 Forks Go MIT 作者: compozy
来源:github.com/compozy/compozy 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

项目已从 v0.2 的 task pipeline 转向 v0.3 beta 的 daemon、durable session 和 Loop 模型,安装通道与命令都变了;旧版概述不能指导当前安装。

来源:github.com/compozy/compozy/releases/tag/v0.3.0-beta.27;https://github…

核心功能

daemon 持有状态

终端关闭后 session 与 Loop 仍归 daemon 管理;事件、资源和工作区边界由同一运行时保存。

来源:github.com/compozy/compozy
可监督的自动化

cron、webhook、trigger、审批、权限、运行状态和产物进入统一对象模型,可从 web 或 CLI 检查。

来源:github.com/compozy/compozy
复用 agent 与扩展

agent 定义放在用户级或工作区级目录;扩展通过声明的 surface 增加工具和运行行为,由 daemon 管理发现、启用、信任和生命周期。

来源:github.com/compozy/compozy
本地优先状态

主程序是 Go 二进制,状态默认落在本机 SQLite;只有配置的 provider、扩展或显式 Gateway 会跨出本机边界。

来源:github.com/compozy/compozy

技术架构

用户或 agent 从 web、CLI、HTTP/SSE、UDS、MCP 等入口发命令;home-scoped daemon 解析工作区,应用权限和运行策略,协调 ACP agent,并持久化事件与资源。全局配置在 ~/.compozy/config.toml,工作区可用 .compozy/config.toml 覆盖,显式 CLI 参数优先级最高。

来源:github.com/compozy/compozy

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) macOS 或 Linux 的已验证安装器,或 Node/npm、Go 源码安装路径macOS 或 Linux… 至少一个受支持且已认证的 agent CLI/provider至少一个受支持且… 本地 daemon 与可写的 Compozy home/workspace本地 daemon 与… 可选 Gateway 用于远程访问可选 Gateway 用… daemon 持有状态 可监督的自动化 复用 agent 与扩展 本地优先状态 compozy 项目本体 核心功能 关键依赖

技术栈

语言Go daemon/CLI + Bun/Vite web UI框架ACP-compatible agent runtime、HTTP/SSE、UDS、MCP
macOS 或 Linux 的已验证安装器,或 Node/npm、Go …至少一个受支持且已认证的 agent CLI/provider本地 daemon 与可写的 Compozy home/workspace可选 Gateway 用于远程访问
SQLite-backed 本地状态;provider、Gateway 与可执行扩展会引入外部网络或代码执行边界
来源:github.com/compozy/compozy

快速上手

当前 v0.3 仍是 beta。macOS/Linux 可用官方脚本安装,或明确安装 @compozy/cli@beta;Go 安装必须把 <release-tag> 换成 release 页的 beta tag。完成后依次运行 compozy install、compozy daemon start、compozy doctor -o json,再进入目标仓库创建 session。先用无写权限的小任务检查 workspace、agent、provider 与审批配置。
来源:github.com/compozy/compozy

使用场景

适合需要让已有 agent CLI 跨终端保存会话、按 cron/webhook 运行、保留审批与产物记录的开发团队。单次问答或临时改一个文件时,直接使用原 agent CLI 通常更省维护;CompozyOS 的价值出现在需要常驻状态和统一监督时。

来源:github.com/compozy/compozy

优势与局限

优势

  • daemon、web 和 CLI 共用一套状态
  • 默认本地 SQLite,远程 Gateway 需要显式开启
  • 支持结构化 CLI 输出和多种控制接口
  • 安装器校验 Sigstore provenance,项目采用 MIT 许可证

局限

  • v0.3 是 beta,官方明确将 v0.2.15 标为弃用且迁移模型不兼容
  • Homebrew 在 beta 期间仍指向 v0.2,Go @latest 也不会得到 v0.3 beta
  • 执行效果仍取决于外部 agent CLI、模型账户和认证
  • 可执行扩展、自动化触发器与远程 Gateway 都需要单独审查权限和密钥
来源:github.com/compozy/compozy

最新版本

GitHub 最新发布为 v0.3.0-beta.27(2026-09-15)。它仍是预发布;v0.2.15 已弃用,只在 legacy/v0.2 分支接受关键修复。

来源:github.com/compozy/compozy/releases/tag/v0.3.0-beta.27

实测与证据

status: docs-only  |  checked_at: 2026-09-23  |  environment: 核对官方 README、安装/快速开始文档、MIT LICENSE 与 GitHub v0.3.0-beta.27 release  |  limitations: 未运行安装脚本、daemon、Gateway、Loop 或任何 agent CLI,也未验证迁移、远程连接和权限隔离  |  observed_output: 最新发布为 v0.3.0-beta.27,release 标注 2026-09-15;README 明确 v0.3 为 beta、v0.2.15 仅保留关键修复

来源:github.com/compozy/compozy/releases/tag/v0.3.0-beta.27

同类项目对比

OpenHands 是软件开发 agent 平台,重点是让 agent 修改代码、执行命令、浏览网页,并可通过 Docker、CLI、headless 或 GitHub Action 使用。CompozyOS 更像已有 ACP agent CLI 外面的运行与监督层,强调 daemon、Loop、审批、触发器和共享状态。需要开箱即用的软件开发 agent 时先看 OpenHands;已有 Claude Code/OpenClaw/Hermes,并要把持续任务纳入统一状态时再看 CompozyOS。

来源:github.com/OpenHands/OpenHands

总结评价

CompozyOS 适合已经有 agent CLI、又确实需要常驻任务、审批和可追踪状态的团队。当前最大成本是 beta 迁移与权限设计;先在单独仓库跑一个 session,确认 provider、workspace 和写权限,再考虑 cron、Gateway 或扩展。

来源:github.com/compozy/compozy

常见问题

CompozyOS v0.3 beta 能直接覆盖 v0.2.15 吗?

不应直接覆盖。官方要求先读 migration guide;v0.3 使用 daemon、durable task 和 Loop,不会恢复 v0.2 的 tasks run 流程。

为什么 Homebrew 或 go install @latest 装不到 v0.3?

beta 期间两者仍指向 v0.2 稳定线。应使用 verified installer、npm 的 @beta,或显式 release tag。

关闭终端后 CompozyOS 的任务还会继续吗?

session 和 Loop 归 daemon 管理,终端关闭不会自动删除状态;是否继续执行仍由 daemon、触发条件和权限决定。

CompozyOS 默认会把工作区上传到云端吗?

官方描述为本地优先,状态默认在本机;外部模型 provider、扩展或显式 Gateway 仍会产生外部数据边界。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件