@calliopelabs/cli

中文文档
3.8.0发布于 2026/11/05MITTypeScriptES Module构建来源已验证近 30 天下载 2137

私人AI代理CLI - 一个终端代理 任何型号后端,包括你自己运行的

中文使用文档
文档目录13 节
  1. 为什么是Calliope
  2. 3.2里有什么新鲜事
  3. 快开始
  4. 配置
  5. ChatGPT 计划访问
  6. 编辑器
  7. 当地克劳德计划进入
  8. 舰队模式
  9. 项目内存
  10. 3⁄4 ̄ ̧漯b
  11. 捐款
  12. 许可证
  13. 代码迁移工具包

卡里欧普CLI

私人AI特工CLI. 任何型号后端都有一个终端代理 包括你自己运行的 麻省理工学院有执照,有小核,没有锁入.

npm install -g @calliopelabs/cli
calliope

单二进制安装通过Homebrew和a curl 安装器, 不需要节点 安装为单个二进制。 。 。 .

为什么是Calliope

  • 任何后端,现场发现. 主机供应商,本地运行时间,与OpenAI兼容的服务器共享相同的工作流程. 从提供者API中发现了模型和能力;不支持或未知的行为保持清晰. 见 供应商矩阵和实线证据。 。 。 .
  • 为你自己运行的模型而建. Ollama和自办OpenAI兼容服务器是一等目标,而不是复选框. 运行全空加载.
  • 沙盒第一处决. 壳和代码工具运行在macOS Seatbelt或多克沙盒内(auto编号 :native编号 :docker编号 :off) (中文(简体) ). 块状是咨询;沙盒是边界.
  • 在长会期内存活下来的安全道. 断路器、重复预算、基站检查站 /restore上下文自动收缩.
  • 治理建设在. Tamper不言自明的审计记录(默认),a replay 命令检查和验证它们,在运行超时停止运行的预算上限,以及外部允许/拒绝引擎的预工具策略钩。 见 文件/施政。 。 。 .
  • 排版判决. calliope judge 对照 noul/choice/core 问题评价一个状态,返回您的代码可以从任何后端(包括本地 Ollama)或本地TypeSafe 引擎上分支的概率和信心。 见 文件/判断。 。 。 .
  • 专注指挥表面. 23个命令,加上可选的舰队模式. 这个 命令引用 记录可用的工作流程和子命令.
  • 被测试为基础设施. 3500个测试,93分线覆盖 强制90%的地板.

3.2里有什么新鲜事

3.2 将提供者基金会转变为项目工作中心:现场提供者保健和 模型发现, /doctor 诊断、健康意识的路径、可复诊、, 流式安全复试,以及 auto 允许模式来自同一区域 终端和无头接口。 它还增加了经过审查的与规划者的协调, 工人和核查者的角色、孤立地执行、有限度的重新试验/重新规划监督, 可审核的文物,以及当地脑/KG的出处-了解出处的项目记忆.

发布内容包括本土贝德洛克推理保存,Google的 @google/genai 适配器,扩展了DeepSeek/Cerebras和OpenAI兼容的覆盖,以及真线 提供证据。 见 3.2.0 发行说明 联 合 国 完整的特性和验证细节.

快开始

calliope --setup        # pick a provider, paste a key (or point at Ollama)
calliope                # start a session in the current directory

在会场内:

/mode plan              think first — the agent proposes, you approve
/mode auto              execute without per-tool approval prompts this session
/model list             see live-discovered models for your provider
/defaults save          save the current provider/model for this project
/scope add ../lib       widen file access deliberately
/compact                compress context when it grows
/restore                list git checkpoints; /restore <path> to roll back
/help                   everything else — it fits on one screen

无头 CI 和脚本:

calliope --headless --json "run the tests and summarize failures"

在固定预算范围内规划项目目标,然后核准退回的散列提案:

calliope orchestrate "Inspect the parser and propose a focused fix" --cost 1 --json
calliope orchestrate approve GOAL_ID PROPOSAL_HASH --allow-mutations --json

规划出口5供审查 目标工作流程 文档 范围限制、批准、追回和JSON合同. /orchestrate 提交 (a) 恢复方案的拟议计划和核准对话.

添加 --supervise --isolation-image sha256:ID (b) 提出一项孤立的工作; 选择分开 控制器、工人和可选执行审查器模型; 现有高级UD显示 角色、任务尝试和有限度的监督回合。 规划仍只读 而执行则需要批准确切的计划.

执行经审查的项目任务图,并配有限定的代理:

calliope run plan.json --dry-run --json
calliope run plan.json --allow-mutations --json

独立任务与每个代理人的许可和共享预算同时进行. 记录文物检查确定完成情况;未经核实的标准要求人为 验收。 见 协调员执行 计划 合同、供应商要求、取消和收回.

本地记录和查询项目知识, 不要求模型 :

calliope brain init --allow-mutations
calliope brain ingest docs/design.md --allow-mutations
calliope brain search "storage decision" --json
calliope kg graph

这个 项目大脑 保存源代码, 支持 人文审查与倒置, 跟踪已失效的文件, 和链接 核实运行的证据. 使用 /brain 财务报告和审定财务报表 /kg 用于REPL中相同的控制.

配置

一个文件,16个钥匙。 证书以每张提供方地图的形式提供,并附有环境可变倒数:

{
  "defaultProvider": "anthropic",
  "providers": {
    "anthropic": { "apiKey": "sk-ant-..." },
    "ollama":    { "baseUrl": "http://localhost:11434" }
  },
  "sandboxMode": "auto",
  "routing": { "enabled": false, "costSensitivity": 0.3 }
}

ANTHROPIC_API_KEY, (中文(简体) ), OPENAI_API_KEY, (中文(简体) ), OLLAMA_BASE_URL朋友和以前一样工作 v2 配置在第一次运行时自动迁移 .

文档 : 开始中 • 妇女 命令 • 妇女 配置 • 妇女 模式偏好 • 妇女 供应商 • 妇女 特性 • 妇女 舰队模式

ChatGPT 计划访问

运行 calliope auth chatgpt login 以选择订阅支持的 OpenAI 访问. 使用 calliope auth chatgpt status 检查账户,以及 api-key 返回到 API收费平台. 见 ChatGPT 计划访问 账户 管理、产出/预算限制和现场核证要求.

编辑器

以 Calliope 身份运行 代理客户协议 代理人(calliope acp) 在Zed,JetBrains,Neovim等ACP编辑器内部——客户端文件编辑,每个工具权限,以及相同的审计线索. 见 文件/附录。 。 。 .

当地克劳德计划进入

运行 calliope claude status,则 calliope claude -- <prompt> 代表你们 已经安装了 克劳德探员 Claude在此拥有权限和计划用途 模式。 见 当地克劳德代表团。 。 。 .

舰队模式

协调一支由特工和人类操作员组成的舰队,覆盖一个自我托管的IRC频道,该频道作为审计线索翻了一番. 默认关闭, 禁用时为零 。 见 文件/传单,md。 。 。 .

项目内存

使用 AGENTS.md 用于便携式寄存器指令和 CALLIOPE.md 用于项目内存。 信任指令从检查出根加载到工作目录,并带有源路径和目录优先级 . /memory sources 显示适用文件; /memory reload 刷新他们。 见 仓库指令。 。 。 .

3⁄4 ̄ ̧漯b

v3是一种故意的减少:84个指令,40个配置键,和~20k行的投机特征(主题包,伴奏,多代理管弦乐,嵌入式API服务器等)被移除,使核心快速,可预见,可维护. 完整清单和理由 变动情况 编辑 v3.0 路线图。 。 。 .

单二进制安装,强制执行性能预算,治理,ACP编辑器集成,以及由v3.0. 见 文件/施政 财务报告和审定财务报表 文件/当地模型。 。 。 .

这个 下一版路线图 优先考虑各提供者之间一致的执行、便携式会话和指示,以及衡量任务可靠性。 这个 首次执行 通过供应商请求、复试和当地程序增加取消,加上范围 AGENTS.md 支助。 见 取消行为。 。 。 .

捐款

问题和PR欢迎—— 捐款额编码库是带有反应/墨水的TypeScript无害环境管理; npm test 必须保持绿色,覆盖必须超过90%.

许可证

麻省理工学院 Calliope实验室公司

代码迁移工具包

包装 迁移游戏本 提供版本 初步清单、基线、评估和核查的协助者 JavaScript-to-TypeScript CLI适配器. 发现他们离线 calliope migration capabilities --json; 本地审查的处决仍然是 授权工人指挥、预算和档案范围.

版本与发布记录

@calliopelabs/cli 共发布 90 个版本,首次发布于 2026/01/10;过去 12 个月发布了 90 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
3.8.0latest2026/11/054 天前
3.7.02026/10/2713 天前
3.6.02026/10/2613 天前
3.5.42026/10/2613 天前
3.5.32026/10/2613 天前
3.5.22026/10/071 个月前

关于 @calliopelabs/cli 的常见问题

@calliopelabs/cli 是什么?

私人AI代理CLI - 一个终端代理 任何型号后端,包括你自己运行的

如何安装 @calliopelabs/cli?

在项目目录运行 npm install @calliopelabs/cli,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 calliope,可以用 npx calliope 直接运行。

@calliopelabs/cli 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@calliopelabs/cli 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@calliopelabs/cli 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=24.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@calliopelabs/cli 可以商用吗?

@calliopelabs/cli 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@calliopelabs/cli 的下载量有多少?

根据 npm 官方下载统计,@calliopelabs/cli 在 2026/10/09 – 2026/11/07 这 30 天内被下载 2,137 次,日均约 71 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@calliopelabs/cli 还在维护吗?

最新版本 3.8.0 发布于 2026/11/05(4 天前);至今共发布 90 个版本,其中过去 12 个月发布了 90 个;首次发布于 2026/01/10。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。