@berthos/cli

中文文档
0.3.1发布于 2026/10/31Apache-2.0ES Module构建来源已验证

泊位命令行—init、dev、test、doctor、mcp、test、os、snapshot、publish、deploy

中文使用文档
文档目录3 节
  1. 使用
  2. 命令
  3. 文档

@berthos / cli

这个 berth 命令:scaffold,运行,测试和部署常驻应用程序,检查您的机器是否可以强制执行,并将应用程序连接到任何MCP客户端。

泊位 在沙盒中运行人工智能代理的工具。每个工具在类中声明它可以接触什么 berth.yml manifest, Linux内核(Landlock和seccomp)执行它。

npm install -g @berthos/cli

需要Node.js 22.19+。在带有KVM的苹果芯片Mac或Linux上,这就是全部:每个沙箱都是一个启动Berth自己内核的小型VM,因此执行不依赖于您的机器,而且是第一个 berth dev 下载它(大约140 MB,每个文件都根据sha256进行检查)。没有KVM的英特尔mac、Windows和Linux使用Docker代替 berth test 和 berth deploy 构建一个容器镜像,所以他们需要Docker在任何地方(文档)。

使用

berth doctor              # can this machine enforce?
berth init my-app         # scaffold a resident app
cd my-app
berth dev                 # boot it in a sandbox, reload on save
berth test                # build the production image and check every export
berth mcp --app my-app    # serve its exports as MCP tools over stdio

命令

命令它是做什么的
berth init [name]搭建一个常驻应用程序(--template, --registry)
berth dev在本地沙盒中使用热加载启动应用程序(--apps 添加配套应用程序, --runtime docker|vm 选择沙盒)
berth test构建生产镜像,检查导出契约,运行应用程序的测试(--json)
berth doctor检查此机器是否可以强制执行功能
berth mcp --app <name>将应用程序的导出公开为MCP工具(--only, --warm, --no-boot)
berth rpc <app> --export <name>直接调用一个导出(--input 将JSON)
berth vm install|status|stop|logs安装和管理本地microVM运行时(文档)
berth os up|down|status保持沙盒运行,以便代码可以立即重新连接到它
berth attest <runId>生成运行的证明记录
berth audit list|verify显示审计跟踪,或检查其散列链
berth snapshot create|list|restore|fork检查点和恢复沙盒
berth deploy --fleet=<e2b|daytona|k8s>部署到远程提供程序
berth fleet status|scale, berth logs管理和跟踪已部署的实例
berth publish --registry=<url>将应用程序发布到 berth-registry
berth tls init生成本地CA和服务器证书

运行 berth <command> --help 每一面旗帜。部署需要在CLI旁边安装匹配的适配器: @berthos/adapter-e2b, @berthos/adapter-daytona 或者 @berthos/adapter-k8s.

berth agent run, berth crew run 和 berth eval 驱动实验性代理框架,该框架尚未发布。它们只能从一个克隆的仓库中工作。

文档

快速入门 · MCP快速入门 · 医生 · 回购

版本与发布记录

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

版本发布日期距今
0.3.1latest2026/10/312 天前
0.3.02026/10/277 天前
0.2.42026/09/271 个月前
0.2.32026/09/271 个月前
0.2.22026/09/271 个月前
0.2.12026/09/271 个月前

关于 @berthos/cli 的常见问题

@berthos/cli 是什么?

泊位命令行—init、dev、test、doctor、mcp、test、os、snapshot、publish、deploy

如何安装 @berthos/cli?

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

@berthos/cli 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/berthos__cli 是否存在。

@berthos/cli 支持 ESM 还是 CommonJS?

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

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

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

@berthos/cli 可以商用吗?

@berthos/cli 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@berthos/cli 还在维护吗?

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