CompozyOS：AI Agent 操作系统

项目简介

CompozyOS 是面向 AI agent 的「操作系统」式运行时。提示词谁都会写，但让 agent 持续干活仍然是一个工程项目：循环、触发器、cron、权限、审批、可观测性，以及把它们粘在一起的脚本。CompozyOS 把这整套 agent 栈做成一个产品，让你用已经在用的 Agent CLI（Claude Code、Codex、Cursor）去创建、自动化和监督 agent 工作。主要面向开发者与技术运营者。

它由 Go 编写，采用本地优先设计：一个 Go 二进制加上 SQLite 存储，运行时状态留在操作者自己的机器上；浏览器、CLI、HTTP/SSE、UDS、MCP 和原生工具读写同一份由 daemon 持有的状态。

主要功能

• 创建：Sessions、agents、Loops、capabilities 都是一次编写、反复复用的对象，而不是每次运行重写的脚本。
• 自动化：cron 计划、webhooks 和触发器让任务在没有人守着终端时继续运行。
• 监督：审批、权限、运行状态、产物和 agent 活动在后台继续工作时依然可查看。
• 工作不随终端消失：Sessions 和 Loop 运行归属于 daemon，关掉某个客户端不会抹掉已有工作。
• 复用现有 Agent：运行 ACP 兼容的 agent CLI 与适配器（如 Claude Code、Codex、Cursor），它们操作同一份 daemon 状态。
• 内置核心对象：loops 与 approvals 是核心对象而非插件，可从 web、CLI、HTTP/SSE、UDS、MCP 访问。
• 远程访问显式化：通过 Gateway 配对设备，只暴露操作者启用的私有或公开面。
• 可扩展：agents、skills、capabilities、hooks 和扩展套件通过明确的运行时契约接入；提供 @compozy/extension-sdk（npm）与 github.com/compozy/compozy/sdk/go，版本与 daemon 匹配。
• 构建外部应用：可用 TypeScript 的 @compozy/client 或 Go 的 github.com/compozy/compozy/sdk/go/client 连接正在运行的 daemon。

安装与使用

多种安装方式：

curl -fsSL https://compozy.com/install.sh | sh
brew install compozy/compozy/compozy
npm install -g @compozy/cli

也可以从源码构建：

git clone https://github.com/compozy/compozy.git
cd compozy
go build -o ./bin/compozy .

快速开始：初始化 home、启动 daemon、进入想让 agent 工作的仓库并创建第一个持久会话。CompozyOS 会从当前目录推断并注册工作区，需要时再用 --workspace 覆盖。

compozy install
compozy daemon start
compozy session new --agent general --name first-run

daemon 由 compozy daemon start、compozy status、compozy daemon stop 管理。

配置方面，全局默认写在 ~/.compozy/config.toml，工作区可用 .compozy/config.toml 覆盖；命令行显式参数优先级最高。

compozy config path
compozy config validate
compozy config show -o json

Agent 定义放在 ~/.compozy/agents/<name>/ 或 .compozy/agents/<name>/，每个定义包含一个 AGENT.md，可附带 agent 本地的 mcp.json；工作区定义会整体覆盖全局定义。

compozy agent list -o json
compozy session new --agent general

扩展开发三步即可跑通：

compozy extension init hello --template tool-provider-go
compozy extension dev hello
compozy tool invoke ext__hello__search --workspace . --input '{"query":"compozy"}'

Skills 是 daemon 发现、带明确来源与作用域的资源，可用 compozy skill list -o json、compozy skill inspect <name> -o json、compozy marketplace search 查看。

注意事项

• v0.4.0 是 CompozyOS 的第一个稳定版本，旧的 v0.2 产品已停止维护；替换现有 v0.2 安装前请先阅读迁移指南，不要直接复制旧的配置或状态目录。
• Task Schema v2 中手写的任务文件仍是带类型化 frontmatter 的 Markdown，但 v0.3 起的运行时会将其导入为持久任务并通过 Loops 执行，不再沿用 v0.2 的 tasks run 流程。
• 应用 SDK（@compozy/client 等）在 0.4 中属于实验性接口，请锁定与 daemon 完全匹配的版本。
• 默认本地优先，远程访问需要显式配置 Gateway 配对设备。
• 完整文档见 compozy.com/docs，CLI 参数以 CLI reference 为准。

本作品整理自 GitHub 开源项目 compozy/compozy，原作者 @compozy，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。