混音系统
特工周围的系统 已经建成了.
AI代理的操作系统.
任何人都可以请人帮忙 让代理持续工作仍然是一个工程项目:循环, 触发器、克龙、权限、批准、可观察性以及持有它们的胶质脚本 一起来 CompozyOS将整个代理堆栈变成一个产品,一个完整的环境到 创建、自动化和监督代理与您已经使用的代理CLI工作(Claude Code, Codex, and Cursor. (原始内容存档于2018-09-29). 先为开发者和技术操作者所建.
[注] v. 4.0是首个稳定的CompoziOS发布. 之前的 v0.2 产品已到寿命结束 不得再被释放。 开始于 移徙指南 在此之前 替换现有的 v. 2. 安装.
重点
- 创建. 会话、代理、循环和能力是您编写并重复使用的对象,而不是 每次重写脚本.
- 自动化. Cron时刻表,webhoks,和触发器保持工作运行,没有终端打开.
- 监督. 批准、许可、运行状态、文物和代理活动可进行检查 而在背景中继续工作.
- 工程在终点站生存. 会话和循环运行属于守护进程, 因此关闭一个客户端 不删除工作.
- 运行您已经使用的代理 . 非加太兼容的CLI(Claude Code、Codex和Cursor) 运行同一个守护进程拥有的国家.
- 包括电池. 一次运行,一次状态模式:循环和批准是核心 对象,而非插件,可以从web,CLI,HTTP/SSE,UDS,MCP,和本地工具中达到.
- 默认为本地第一. 一个去二进制和SQLite后置的商店保持运行时态 操作员的机器,除非配置的提供者或扩展拥有外部边界.
- 远程访问明确无误. 这个 网关 双相设备,并只暴露操作员所允许的私人或公共表面.
- 建为通延. 特工、技能、能力、钩子和扩展包插入 明确的运行时间合同.
* 安装
已验证的安装器
安装者在安装前将最近发布的版本标出并验证Sigstore出处 macOS或Linux上的二进制.
curl -fsSL https://compozy.com/install.sh | sh
土生土长
brew install compozy/compozy/compozy
国家预防机制
npm install -g @compozy/cli
走开
安装, 使用显示在 最新发布数字 :
go install github.com/compozy/compozy@<release-tag>
从源
git clone https://github.com/compozy/compozy.git
cd compozy
go build -o ./bin/compozy .
这个 安装指南 覆盖 安装者旗, Linux 软件包, 源代码构建, 校验, 以及管理的更新 .
* 如何运作
人民和特工通过公共控制表面发出命令. 主瞄准守护进程解析 工作空间,应用权限和运行时间政策,协调非加太代理机构,以及持续发生的事件 资源状态。 网络和流媒体客户端读取同一守护进程拥有的真理,而不是维持一个 并行模式.
守护进程运行时模式
compozy daemon start, (中文(简体) ), compozy status,以及 compozy daemon stop 管理本地守护进程 .
会话、任务、循环运行,
自动化和工具保持明确的所有者和工作空间界限。 使用
结构化的 CLI 输出 (-o json), HTTP/SSE, UDS, MCP, 或当另一个代理或程序时的本地工具
需要管理同样的资源.
任务Schema v2
授权任务文件仍为可移植 Markdown 有打出前题 。 v0.3 运行时间导入它们
进入持久任务,并通过循环执行; 它不会使 v0. 2 恢复 tasks run 输油管.
见 从v. 2.15 迁移 精确的策略和命令更改.
QQ 配置文件
全球默认存在 ~/.compozy/config.toml; 工作空间可以通过
.compozy/config.toml。明确命令旗胜过工作空间配置,工作空间配置胜出
全局配置和内置默认值.
compozy config path
compozy config validate
compozy config show -o json
配置、证书和供应商家庭政策有不同的所有人。 跟着 配置指南 而不是复制 v0.2状态为 v0.3 家.
可重复使用的代理工具
代理定义在下面 ~/.compozy/agents/<name>/ 或者说 .compozy/agents/<name>/。每个定义
有一个 AGENT.md 并且可能包括当地代理人 mcp.json. 工作空间定义凌驾全球
定义作为一个整体.
compozy agent list -o json
compozy agent info general -o json
compozy session new --agent general
++ 扩展
扩展通过声明添加版本资源并运行时间行为提供表面. 守护进程 拥有发现、授权、信任决定、生命周期和钩子;扩展不会绕过公共 运行时间合同.
3个命令中建一个
compozy extension init hello --template tool-provider-go
compozy extension dev hello
compozy tool invoke ext__hello__search --workspace . --input '{"query":"compozy"}'
可执行扩展名是代码先: 一次在代码中声明工具并 compozy extension build
生成列表。 仅限资源的扩展可以代替手写 extension.toml 并使用
相同的构建, dev, 重新加载, 和监视循环而不运行扩展代码. 走过 :
构建您的第一个扩展名。 。 。 .
SDK 支持
@compozy/extension-sdk (npm,麻省理工学院)和 github.com/compozy/compozy/sdk/go 发表和
版本匹配到守护进程 .
扩展 CLI
compozy extension list -o json
compozy extension status <name> -o json
compozy extension provenance <name> -o json
compozy extension logs <name> --follow
学多点
构建应用程序
使用 @compozy/client 用于类型脚本或 github.com/compozy/compozy/sdk/go/client 用于连接
您运行守护进程的一个外部应用程序 。 两个客户都提供打字业务和代理流;
应用程序令牌授权本地收听器上的可信任浏览器来源 .
跟着 构建应用程序教程 对于节点,一个服务器支持的聊天UI, 浏览器访问,去,和令牌管理. 这个 API 参考 包括每次操作生成的SDK呼叫. 这些应用SDK表面在0.4中为实验; 标出匹配您守护进程的确切版本 .
QQ 快速启动
启动守护进程, 进入您想要代理的仓库, 并创建一个
持续的会议。 CompozyOS 从当前目录中推断并注册工作空间; 使用
--workspace <id|name|path> 只有在你需要控制时.
compozy install
compozy daemon start
compozy session new --agent general --name first-run
这个 快速启动 继续通过 首先迅速,现场的附着,检查,和清理.
技能
技能是守护进程发现的资源,有明确的来源和范围. 使用结构化的技能和 市场表面,用于检查活动内容,而不是向前复制 v0.2 设置目录.
compozy skill list -o json
compozy skill inspect <name> -o json
compozy marketplace search --kind skill --query <term> -o json
工作流程内存
工作流内存是普通寄存器文件 .compozy/tasks/<name>/memory/,写作和阅读
光谱循环技能。 v.0.2工作流程-记忆文件仍然是仓库文物;它们不是
导入为隐藏运行时状态.
* 支助代理人
CompozyOS运行ACP兼容剂CLI和适配器. 活动提供者目录和每个代理目录 运行时设置是运行时的真伪;在选择模型或推理模式之前检查它们. 见 提供者指南 用于认证和 提供家庭政策.
CLI 参考
生成的 CLI 参考 对动词是权威的, 旗帜、结构输出和退出行为。 以 :
compozy --help
compozy version
compozy doctor -o json
文档
发展
CompoziOS是Go和Bun monorepo的游戏. 以自动 Go 启动守护进程 虚拟高频:
make dev
要使用北星付费演示并让守护进程运行在背景中:
make demo-seed
# Optional isolated home and secondary port:
make demo-seed DEMO_HOME="$HOME/.compozy-demo-other" DEMO_PORT=2125
这构建了守护进程和 Web 捆绑, 替换种子拥有的情景, 并开始
演示在 http://localhost:2124 使用 ~/.compozy-demo 默认。 主要内容
实例不变。 要重播正在运行的演示, 请先用
COMPOZY_HOME="$HOME/.compozy-demo" ./bin/compozy daemon stop (使用您的自定义的家)
如果被推翻的话。 生下来的 go run ./scripts/demo-seed --home <path> 命令保留
仅供数据种子使用。 现有演示 ~/.agh 仍然可以选择
明确使用 DEMO_HOME。 。 。 .
为了准备同样的演示并在电子桌面外壳中打开:
make demo-seed-desktop
# The same overrides apply:
make demo-seed-desktop DEMO_HOME="$HOME/.compozy-demo-other" DEMO_PORT=2125
桌面外壳使用演示主机进行运行时连接和 Electron
简介。 取出电动让演示守护进程在背景中运行.
一样 demo-seed在重播之前, 停止一个已经运行的演示.
在实施或推进前先运行受影响的当地大门:
make gate
交付在PR草案中完成:等待每一次所需的CI检查来传递其当前头部.
读取 一般事务人员(其他职等) 和编辑前的表面指示.
恒星历史
捐款
欢迎捐款。 打开一个问题或拉请求, 保持公共行为代理管理
运行 make gate 在发送更改前, 然后保留 PR 直至其当前标题 CI 为绿色 . 安保报告 属于仓库
私人安全频道 不是公共问题.
贡献者
感谢所有为CompozyOS做出贡献的人.
许可证
CompozyOS 以 MIT 许可证。 。 。 .