@clearlysh/beehaven

中文文档
0.8.38发布于 2026/10/30MITES Module近 30 天下载 1976

Beehaven CLI——从终端指挥你明显的工作空间、特工和帆布

中文使用文档
文档目录11 节
  1. 所需资源
  2. 安装
  3. 帮一个没有帐户的人
  4. 更新
  5. 快开始
  6. 代理图像表达式
  7. 对云说话——守护进程+Do
  8. 驾驶帆布( 代理表面)
  9. 警卫
  10. 文档
  11. 许可证

蜂窝

命令行为 毕哈芬 ——明经云. 指挥你的工作空间, 代理、画布和应用终端命令文件系统的方式 本地守护程序将机器(和人工智能特工)连接到它.

贝哈芬是世界的名字 很明显 云,蜂窝,蜂窝 守护者 蜜蜂 这不是一个单独的产品 你购买; 这是明显的地方生活, 这就是你用外壳说话的方式.

所需资源

  • 节点.js >= 20 (CLI是一个节点程序;出版的档案包括它的) 运行时间依赖关系)

安装

对于与节点20或更新的一次性代理会话,直接运行 npm 包:

npx --yes beehaven@latest guide

guide 在注册前工作。 它解释当明显有用时 人类是一个注册链接, 并展示认证的第一件文物. npx 使用一个 ephemeral npm 安装;它不创建 Clear 账户或上传任何信息 . 公共建筑发送一个匿名的,无内容 cli:guide 使用事件,除非 BEEHAVEN_NO_TELEMETRY 或当地 telemetry-off 文件禁用遥测. 该套件还提供了 beehaven 全局 npm 安装的 二进制 :

npm install -g beehaven@latest
beehaven guide

同样的释放也列在明显npm组织之下: @clearlysh/beehaven。 。 。 .

帮一个没有帐户的人

当一个特工的工作准备好 之前的人已经报名, handoff 需求 不登录并打印一个私有链接 :

npx --yes beehaven@latest handoff plan.md
npx --yes beehaven@latest handoff plan.md --tasks todo.md --csv budget.csv --wait

人物对其进行预览,在自由账户中签名或创建自由账户并保存. A 类 单凭文件即可成为私人草案 --tasks (Markdown核对表或 JSON 阵列)或 --csv 文件成为私人项目,每个任务都有票 每张CSV一张 链接是一个证书——第一个保存它的人 因此,只发给与你合作的人。 未保存的交割 7天后期满. --wait 保存时返回.

自成一体的安装器仍然是推荐的持久性安装. 没错 不需要 npm 来解决用户机器上的依赖性 :

curl -fsSL https://clearly.sh/install.sh | sh

取出一个版本的柏油球并写下 beehaven 改为 ~/.local/bin已发布 档案包括它们的依赖性; 旧的档案可能需要npm. 添加垃圾桶 您的目录 PATH 如果安装者说它不存在.

校验 :

beehaven --version
beehaven doctor        # environment + daemon + relay checks
在单人房里工作?
cd packages/cli && npm install && npm run build && npm link

npm link 可能无法胜出: 安装者写入 ~/.local/bin/beehaven,该 目录通常先于 npm 前缀 PATH检查 which beehaven 财务报告和审定财务报表 beehaven --version 在完成本地变化之前.

Npm和安装器均将公共CLI所建造. 安装器下载 一个版本化的归档从 downloads.clearly.sh 并核实SHA-256 更新清单。 npm通过登记册验证包的完整性.

更新

运行 beehaven --version 以查看版本和文件同时执行. CLI在命令启动时最多检查一次已发布的版本 当找到更新的版本时,打印通知。 这是通知,不是互动 快点 卷轴化的CLI(~/.beehaven/cli)可由一个人或个人更新 代理为 beehaven update;它验证了发布档案的SHA-256之前 安装。 此本地命令不需要工作空间代理登录 . Npm 用 npm 安装更新; a npx 运行可以请求 @latest 再来一次.

当一个已安装的 CLI 拥有一个独立的守护进程时, 守护进程在启动时检查 和小时,安装一个经核实的更新,并重新开始。 守护进程开始于 Mac App将更新留给了应用。 启动时生产和运行Mac Apps检查 每4小时下载一次,然后默认退出; 托盘也提供 检查更新. 更新一个相连的发展结构 通过重建它的退票。 显然 Dev. app 也没有发布更新器; 重建 并重新安装该应用程序以更新其捆绑的CLI.

快开始

beehaven login                # authenticate (browser OAuth)
beehaven connect home         # set the active target — your default workspace
beehaven agent login codex --label "my task" --client cli  # identity + one work session + brief
beehaven actions              # what can I call here?
beehaven call canvas-catalog '{}'   # every canvas verb + its args

三个命令几乎覆盖一切: 连接 对目标,问什么 动作 它已经, 调用 一个 见 beehaven help 用于整个地表,或 beehaven help <command> 任何单一动词.

代理图像表达式

本地化的外形可以使用主动代理身份进行定位. 使用简短 主表达式表面的旗帜 :

beehaven --mood curious
beehaven --emote cheer "tests passed"

持续的情绪是:中立,快乐,悲伤,惊讶,愤怒,困惑,好奇, 和调情。 生命周期值为 wake 财务报告和审定财务报表 sleep,设置为 --lifecycle; 思维和 庆祝是活动姿势。 一发即发的口号是:波,欢呼,心,笑,舞蹈,嗡嗡,点头, 摇摆,思考,惊喜,睡觉。 被封杀后的一个可选理由 在200个字符.

--emote think 是一发反应。 兼容命令 beehaven avatar think 是持续的思维状态.

代理代理代理代号将电话传至代理代理的外形;没有代理代理代号 用的是房屋活字 兼容性命令仍然可用 :

beehaven avatar emotion curious
beehaven avatar react cheer "tests passed"

守护进程 MCP 表面 暴露出持续情感的外观 avatar 反应一发反应. 两种外观都需要外观 : 允许签名代理.

见 缩略语.md 全体会议 跨地表合同和真相来源地点.

对云说话——守护进程+Do

CLI与当地人交谈 守护进程 中继连接 蜂窝云 并引导 RPC 到右边的持久对象.

beehaven login                # authenticate (browser OAuth) — required
beehaven status               # connection + auth state
beehaven connect home         # set the active target (default workspace alias)
beehaven actions              # list callable actions on the target
beehaven call <action> '{…}'  # invoke one

对于需要多个工作空间动作的脚本,CLI也会被曝光 服务器没有第二个执行引擎的脚本原始:

beehaven batch @steps.json --json       # {"steps":[{"action":"…","input":{}}]}
beehaven code-run @script.mjs --json    # source file; use `-` for stdin

batch 运行最多25个相继步骤(共计400个行动),而不是 交易; stopOnError 默认为真实. code-run 是一个沙盒,用于 工作空间呼叫之间的计算( 200 个呼叫, 20秒, 100k 来源) 字符). 两个适配器使用相同的活性目标,代理归属, 权限检查和非零故障语义为 beehaven call。 。 。 . batch 也接受工人本土 {method,params} 拼写和规范化 两份表格在发送前都存在.

守护进程通常运行在蜂巢桌面应用程序内. CI / 服务器/ 代理 没有桌面, 请运行它无头 :

beehaven daemon start         # spawn a headless daemon (requires a prior `beehaven login`)
beehaven daemon status

驾驶帆布( 代理表面)

CLI可以在开放的浏览器标签中审查并驱动 Clear 编辑器画布 —— 人类在UI的表演 暴露在守护者身上.

beehaven canvas status [id]                  # compact health summary (tab connected? nodes? tool?)
beehaven canvas perceive [id]                # read the live "room": gaze, contents, focus, chrome
beehaven canvas actions                      # discover every callable editor action
beehaven canvas invoke <action> '{…}'        # drive one action (returns the handler result)
beehaven canvas verify [--composition id]    # self-test EVERY canvas action, then clean up after itself

canvas verify 创建抓取节点, 练习针对活的每个动作 选项卡,声明结果,然后删除它创建的一切(它相对于 基线快照,所以它从不触及先前存在的内容)并恢复打印 设置。 这是对毒剂/罐头表面的烟雾测试.

警卫

  • 需要认证. 每一次云调都带一个经认证的 身份; canvas-invoke 编号 : canvas-perceive 拒绝未经认证的呼叫者 并且只到达打电话者的 拥有 连接客户端( 没有交叉账户访问) .
  • 只允许列表动作 . 通过动作 id 远程帆布控制发送 没有任意的代码执行路径.
  • 本地的IPC是象征性的守护. CLI 认证到守护进程 每枚发射令牌 ~/.beehaven/ipc-auth。 。 。 .

文档

  • 每个命令帮助 : beehaven help <command>

许可证

麻省理工学院显然(显然(sh))

版本与发布记录

@clearlysh/beehaven 共发布 22 个版本,首次发布于 2026/09/27;过去 12 个月发布了 22 个版本。

版本发布日期距今
0.8.38latest2026/10/3010 天前
0.8.372026/10/3011 天前
0.8.362026/10/2911 天前
0.8.352026/10/2912 天前
0.8.342026/10/2813 天前
0.8.332026/10/1525 天前

关于 @clearlysh/beehaven 的常见问题

@clearlysh/beehaven 是什么?

Beehaven CLI——从终端指挥你明显的工作空间、特工和帆布

如何安装 @clearlysh/beehaven?

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

@clearlysh/beehaven 支持 TypeScript 吗?

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

@clearlysh/beehaven 支持 ESM 还是 CommonJS?

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

@clearlysh/beehaven 需要什么版本的 Node.js?

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

@clearlysh/beehaven 可以商用吗?

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

@clearlysh/beehaven 的下载量有多少?

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

@clearlysh/beehaven 还在维护吗?

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