BE AI 的 CLI 客户端

CLI 客户端 蜜蜂 ——可穿戴的人工智能,能捕捉你的谈话并了解你.

[大 要使用 CLI , 您必须安装最新的 Be app 并启用开发者模式, 在 Sets 中使用 app 版本 5 次 .

怎么会这样?

蜜蜂是个 加密 可穿戴的个人AI设备,静静地坐在背景中,捕捉到您一整天的对话和经验. 它记录和加密了您的数据,只提供给您。 然后在安全计算单元内,它将环境上下文转换为:

• 谈话记录 使用扬声器识别
• 每日摘要 活动和讨论情况
• 事实 - 事情BE学会和记得你
• 待办事项 从您的谈话中提取的动作项目
• 个人见解 和模式

蜂能理解40+语言,特征是14天的电池活,并与iOS应用程序合作,为您提供一个可搜索,AI动力的人生记忆.

为什么是蜜蜂CLI?

Bee CLI 将您的个人数据导出为平分文件, 并提供给:

• AI探员:给克洛德,GPT,或其他助手你的个人背景,让他们更有效地帮助你
• 本地搜索: 使用 grep, riggrep, 或您的编辑器搜索您所有的对话
• 备份: 保留一个便携式的、离线的BE数据副本
• 自定义集成: 以您的对话历史、事实和待办事宜构建工作流程

使用带有 AI 助手的 Bee( MCP)

蜜蜂CLI也是个 示范背景协议 服务器,因此克劳德和Codex等助手可以读取你的Bee语境——搜索对话,查找事实和待办事宜,取取出每日摘要——直接,将您的数据留在你的机器上.

一步内连接到客户端 :

bee mcp connect claude          # Claude Desktop (one-click install)
bee mcp connect claude-code     # Claude Code (CLI)
bee mcp connect codex           # Codex
bee mcp status                  # show what's connected
bee mcp disconnect claude-code  # remove

服务器通过您已有的 Bee 登录进行认证—— 没有额外的符号管理 。 直接使用其中一种运算方式

bee mcp serve                   # stdio JSON-RPC (what the connectors launch)
bee mcp serve-http [--port N]   # local HTTP, 127.0.0.1, bearer-token auth

[注] serve-http 仅与本地主机绑定, 并需要一个认证符, 提供 --token 或 BEE_MCP_HTTP_TOKEN 环境变量(至少32个字符). 客户端发送为 Authorization: Bearer <token>。 。 。 .

以下每个读取、搜索和管理能力都作为MCP工具曝光(bee_search, (中文(简体) ), bee_list_facts, (中文(简体) ), bee_get_daily_summary,所以CLI和你的助手工作 从相同的数据.

对于Bee测试用户来说,线程工具允许一个助手与Bee代理聊天: bee_create_thread, (中文(简体) ), bee_send_thread_message, (中文(简体) ), bee_wait_thread, (中文(简体) ), bee_list_threads, (中文(简体) ), bee_get_thread_messages,以及 bee_abort_thread,发送工具附加本地文件(file_paths)或内置碱基64文件(inline_files) (中文(简体) ). 他们等着 timeout_seconds (default 45,在大约60秒的限制下,许多MCP客户提供工具呼叫;); 0 发送不等待。 每个结果都有 status, (中文(简体) ), thread_id, (中文(简体) ), message_id,和(发送) client_message_id 在顶层。 何时 status 实值 pending电话 bee_wait_thread 和那些IDs继续等待。 若为 message_id 无效,Bee没有及时确认发送。 使用相同的调用发送工具 client_message_id;这样可以恢复信息,从不重复发送. 如果一个工具呼叫被切断, bee_wait_thread 仅限 thread_id 继续等待,并 bee_list_threads 找到一条新线.

安装

从 npm 安装 :

npm install -g @beeai/cli

或从发布页面下载最新发布或从来源构建.

使用量

bee <command> [options]

图书馆(节点)

您也可以导入一个小库包, 将外壳切入到 bee 二进制 并使用 JSON 输出旗帜。 这在Node.js运行. 保证 bee 交给你了 PATH,或者通过习惯 command 创建客户端时的路径.

import { createBeeClient } from "@beeai/cli/lib";

const bee = createBeeClient();
const profile = await bee.api.me();

// Test users: chat with the Bee agent; keep waiting while status is "pending".
type Answer = { status: string; thread_id: string; message_id: string; text?: string };
let answer = await bee.api.threads.create<Answer>({ text: "Plan my day", timeout: 120 });
while (answer.status === "pending") {
  answer = await bee.api.threads.wait<Answer>(answer.thread_id, { after: answer.message_id });
}

const stream = bee.sse.streamJson({ types: ["new-utterance"] });
for await (const event of stream.events) {
  console.log(event.data);
}

图标

默认情况下,数据命令返回标记下. 使用 --json 打印生JSON.

• login - 互动登录,与 --token <token> 编号 : --token-stdin,或通过代理 --proxy <url|socket>启用 --no-wait 立即打印认证链接并退出,而不是进行投票供批准(对代理/自动化有用;稍后用完) bee status 或者通过重新运行 bee login) (中文(简体) ).

• status - 显示当前认证状态 .

• logout - 清除和清除储存的证书.

• me - 获取您的用户简介 。 使用 --json jSON的输出.

• today - 获取今天的简介(日历事件和电子邮件) 。 使用 --context 可穿戴的蜜蜂上下文(每日摘要、活起的待办事宜、笔记、谈话)改为 --json jSON的输出.

• now - 获取过去10小时的谈话 与语音。 使用 --json jSON的输出.

• activity - 展示最近的活动,包括对话、摘要、笔记、待办事宜和见解。 选项 : --limit N, (中文(简体) ), --json。 。 。 .

• changed - 获取最近的更改( 默认为持续24小时) 。 使用 --cursor <cursor> 财务报告和审定财务报表 --json jSON的输出.

• stream - 流出实时活动。 选项 : --types <list>, (中文(简体) ), --json, (中文(简体) ), --agent, (中文(简体) ), --webhook-endpoint <url>, (中文(简体) ), --webhook-body <template>。 。 。 .

• facts - 管理你的事实(Bee记得你的事).

  • facts list - 列出事实 选项 : --limit N, (中文(简体) ), --cursor <cursor>, (中文(简体) ), --unconfirmed, (中文(简体) ), --json。 。 。 .
  • facts get <id> - 获取一个具体的事实。 选项 : --json。 。 。 .
  • facts create --text <text> - 创造出一个新的事实。 选项 : --json。 。 。 .
  • facts update <id> - 更新事实。 选项 : --text <text> (省去时保留了现有案文), --confirmed <true|false>, (中文(简体) ), --json。 。 。 .
  • facts confirm <id> - 确认事实 confirmed=true在保留其现有案文的同时。 选项 : --json。 。 。 .
  • facts delete <id> - 删除一个事实。 选项 : --json。 。 。 .
  • facts search --query <text> - 搜索保存的事实。 选项 : --limit N, (中文(简体) ), --json。 。 。 .

• todos - 管理好你的待办事.

  • todos list - 列出待办事宜。 选项 : --limit N, (中文(简体) ), --cursor <cursor>, (中文(简体) ), --json。 。 。 .
  • todos get <id> - 找个具体的工作 选项 : --json。 。 。 .
  • todos create --text <text> - 创建一个新的待办事宜。 选项 : --alarm-at <iso>, (中文(简体) ), --json。 。 。 .
  • todos update <id> - 更新一个待办事宜 选项 : --text <text>, (中文(简体) ), --completed <true|false>, (中文(简体) ), --alarm-at <iso>, (中文(简体) ), --clear-alarm, (中文(简体) ), --json。 。 。 .
  • todos complete <id> - 标记一个待办事宜完成。 选项 : --json。 。 。 .
  • todos delete <id> - 删除一个待办事宜。 选项 : --json。 。 。 .
  • todos suggestions - 列出蜜蜂推荐的待办事宜 选项 : --limit N, (中文(简体) ), --json。 。 。 .
  • todos accept-suggestion <id> - 接受一个建议做, 把它变成一个真正的做。 选项 : --json。 。 。 .
  • todos dismiss-suggestion <id> - 解除一个建议做的工作。 选项 : --json。 。 。 .

• conversations - 获取你的录音谈话.

  • conversations list - 名单对话。 选项 : --limit N, (中文(简体) ), --cursor <cursor>, (中文(简体) ), --json。 。 。 .
  • conversations get <id> - 得到一个具体的谈话 与完整的记录。 选项 : --json。 。 。 .
  • conversations transcript <id> - 把记录稿拿来 使用 --since <epochMs> 仅返回在特定时间或之后(划一毫秒)所发表的言论——方便投票,只提供新言论的实况记录。 选项 : --since <epochMs>, (中文(简体) ), --json。 。 。 .
  • conversations related <id> - 找到一个相关的谈话 选项 : --limit N, (中文(简体) ), --json。 。 。 .

• daily - 每日查阅活动摘要.

  • daily list - 列出每日摘要。 选项 : --limit N, (中文(简体) ), --cursor <cursor>, (中文(简体) ), --json。 。 。 .
  • daily get <id> - 获得具体每日摘要。 选项 : --json。 。 。 .
  • daily find <YYYY-MM-DD> - 找到约会的每日摘要 选项 : --json。 。 。 .

• journals - 打开你的日记.

  • journals list - 列出日记。 选项 : --limit N, (中文(简体) ), --cursor <cursor>, (中文(简体) ), --json。 。 。 .
  • journals get <id> - 找一份特定的日记 选项 : --json。 。 。 .
  • journals search --query <text> - 搜索语音笔记/日记条目。 选项 : --limit N, (中文(简体) ), --json。 。 。 .

• insights - 访问 蜜蜂对你的看法.

  • insights list - 列出最近的见解 选项 : --limit N, (中文(简体) ), --cursor <cursor>, (中文(简体) ), --json。 。 。 .
  • insights get <id> - 获取一个具体的见解。 选项 : --json。 。 。 .

• locations - 进入你去过的地方.

  • locations clusters - 显示按访问频率分组的地方。 选项 : --limit N, (中文(简体) ), --min-visits N, (中文(简体) ), --visits, (中文(简体) ), --json。 。 。 .
  • locations recent - 显示最近的个人访问。 选项 : --from <date>, (中文(简体) ), --to <date>, (中文(简体) ), --limit N, (中文(简体) ), --json。 。 。 .
  • locations current - 显示你最新的位置 选项 : --json。 。 。 .

• photos - 访问照片同步 从你的相册.

  • photos list - 列出照片,最新的第一。 选项 : --daily-id N, (中文(简体) ), --date YYYY-MM-DD, (中文(简体) ), --limit N, (中文(简体) ), --json。 。 。 .
  • photos get <id> - 下载一张照片。 选项 : --output <path>, (中文(简体) ), --json。 。 。 .

• search - 搜索你的蜜蜂数据.

  • search --query <text> - 关键词搜索(默认)包括对话、每日摘要和事实。 范围 --filter conversations|daily|facts|all 顺序与 --sort relevance|mostRecent启用 --neural 用于语义性对话搜索(仅限对话); --filter编号 :--sort (不适用)。 按时间对任一模式进行约束 --since编号 :--until (epoch milli seconds) (英语). 选项 : --limit N, (中文(简体) ), --json。 。 。 .

• threads - 用线程与蜜蜂代理商聊天(只限蜜蜂测试用户).

  • threads list - 列出其编号、名称和状态的线索(idle 或者说 running选项 : --json。 。 。 .
  • threads create --text <text> - 启动一条新线 以第一个消息等待答案。 选项 : --photo <path> 财务报告和审定财务报表 --file <path> (可重复;先上传,每封信最多20个,每封信25个MB), --timeout <duration>, (中文(简体) ), --client-message-id <id>, (中文(简体) ), --json。 。 。 .
  • threads send <thread-id> --text <text> - 给一条已有的线条发送信息,等待答案。 与 create。 。 。 .
  • threads wait <thread-id> - 继续等答案 等待线程的最新用户消息后, 或者等待 --after <message-id>选项: --after <message-id>, (中文(简体) ), --timeout <duration>, (中文(简体) ), --json。 。 。 .
  • threads messages <thread-id> - 显示线条的信息,最古老的第一。 选项 : --limit N (最新N), --json。 。 。 .
  • threads abort <thread-id> - 停止特工当前在线上的工作。 选项 : --json。 。 。 .

  --timeout 约束整个发送和等待,例如. 30s, (中文(简体) ), 5m,或 1h (赤数为秒. 默认为 90s,以及 0 发送不等待。 服务器等待, HTTP 超时, 并在最后期限前全部结束 。 唯一的例外是发送本身: 它总是得到至少10秒,所以 0 仍然传递信息。 上传是先上传的,不计数。 更长时间的等待被分为最多55秒的服务器呼叫. 当答案没有及时准备好时,命令仍然成功:它打印出线程 id,消息 id, status: pending,则a bee threads wait <thread-id> 指点 A 类 stalled 状态表示代理人有一段时间没有报告进度:再次等待,或中止并再次发送。 答案文本首先出现在降标输出; --json 打印全部有效载荷( y)status, (中文(简体) ), thread_id, (中文(简体) ), message_id, (中文(简体) ), client_message_id, (中文(简体) ), hint, (中文(简体) ), text, (中文(简体) ), messages, (中文(简体) ), files) (中文(简体) ).

  每次发送都带有 client_message_id生成,除非您通过 --client-message-id。打印后,信件可能存有每个结果和任何错误。 重复重用它,所以一个消息从来没有发出过两次. 重运行同一命令 --client-message-id <id> 恢复信息而不是发送新的信息。 上面还写着BE没有及时确认 message_id: (not confirmed)。重新运行 create 以相同的ID返回相同的线程. 照片和文件在消息发送前上传;如果有任何上传失败,则不发送. 在Bee应用中附设它们需要Be代理的同意.

• mcp - 运行或连接 MCP 服务器(参见 使用配有 AI 助手的 Bee。子命令 : serve, (中文(简体) ), serve-http [--port N] [--token VALUE], (中文(简体) ), connect|disconnect <claude|claude-code|codex>, (中文(简体) ), status。 。 。 .

• sync - 把你的蜜蜂数据导出给AI探员 重跑是默认的递增(只有更改了的每日摘要,对话,和见解被重提). 选项 : --output <dir>, (中文(简体) ), --recent-days N, (中文(简体) ), --only <facts|todos|daily|conversations|insights>, (中文(简体) ), --full, (中文(简体) ), --since <epochMs>。 。 。 .

• proxy - 开始本地的Bee API代理。 选项 : --port N, (中文(简体) ), --socket [path], (中文(简体) ), --idle-timeout SECONDS。 。 。 .

• ping - 运行快速连接检查。 使用 --count N 重复一遍 重复一遍.

• version - 打印CLI版本。 使用 --json jSON的输出.

代理认证

当另一个可信任的本地进程处理 Bee API 认证时使用代理认证,而这个 CLI 应该通过它发送请求.

配置代理模式

# HTTP proxy
bee login --proxy http://127.0.0.1:8787

# Unix socket proxy
bee login --proxy ~/.bee/proxy.sock

这将代理配置保存到 ~/.bee/proxy-{env}.json。当代理配置存在时,它优先于存储的代号认证.

启动本地代理服务器

# TCP listener (default auto-picks from 8787)
bee proxy
bee proxy --port 8787
bee proxy --idle-timeout 300

# Unix socket listener (default: ~/.bee/proxy.sock)
bee proxy --socket
bee proxy --socket /tmp/bee-proxy.sock

Bee Proxy设定了 Bun的服务器空闲超时,默认为120秒. 使用 --idle-timeout SECONDS 用于大型出口,或 --idle-timeout 0 以禁用闲置请求超时。 在套接字模式下, CLI 将删除 stale 套接字 在监听前的文件 .

串流事件

使用 bee stream 以接收服务器发送事件。 您可以过滤事件 --types (合并分离)或通过 --types all 以获得一切。 每个 事件包括 event 名字和一个JSON data 载荷.

使用 --agent 用于单行、方便代理的输出,例如: Event new-utterance: [speaker_1] "Hello there" conv=uuid-string。 。 。 . Webhook 模板使用相同的方便代理信件 {{message}}。 。 。 .

以下是事件类型和CLI预期/打印的有效载荷字段.

已连接

溪相接而发. 这个 data 有效载荷一般为空或被忽略.

新发作

新笔录片段.

有效载荷 :

{
  "utterance": {
    "text": "Hello there",
    "speaker": "speaker_1"
  },
  "conversation_uuid": "uuid-string"
}

新对话

对话被创造.

有效载荷 :

{
  "conversation": {
    "id": 123,
    "uuid": "uuid-string",
    "state": "processing",
    "title": "Optional title"
  }
}

更新对话

对话更新 .

有效载荷 :

{
  "conversation": {
    "id": 123,
    "state": "processed",
    "title": "Optional title",
    "short_summary": "Optional short summary"
  }
}

更新-对话-摘要

更新了简短摘要.

有效载荷 :

{
  "conversation_id": 123,
  "short_summary": "Summary text"
}

删除对话

对话被删除 .

有效载荷 :

{
  "conversation": {
    "id": 123,
    "title": "Optional title"
  }
}

更新位置

对话位置更新 .

有效载荷 :

{
  "conversation_id": 123,
  "location": {
    "latitude": 37.77,
    "longitude": -122.41,
    "name": "Optional name"
  }
}

已创建

托多创建.

有效载荷 :

{
  "todo": {
    "id": 10,
    "text": "Call dentist",
    "completed": false,
    "alarmAt": 1700000000000
  }
}

任务更新

更新了todo(与todo-created相同的有效载荷).

待办事项已删除

待办删除 .

有效载荷 :

{
  "todo": {
    "id": 10,
    "text": "Optional text"
  }
}

日记创建

创刊.

有效载荷 :

{
  "journal": {
    "id": 55,
    "state": "processed",
    "text": "Optional raw text",
    "aiResponse": {
      "message": "Optional assistant message",
      "cleanedUpText": "Optional cleaned text",
      "followUp": "Optional follow up",
      "todos": ["Optional todo"]
    }
  }
}

日记更新

期刊更新(与期刊创建时的有效载荷相同).

日记已删除

杂志被删除.

有效载荷 :

{
  "journalId": 55,
  "reason": "Optional reason"
}

日记文本

原始日记文本流入(例如作为语音注释被转录).

有效载荷 :

{
  "journalId": 55,
  "text": "Optional raw text"
}

同步命令

这个 sync 命令将您的全部 BE 数据导出到本地目录中,作为下标记文件.

使用量

bee sync [--output <dir>] [--recent-days N] [--only <facts|todos|daily|conversations|insights>] [--full] [--since <epochMs>]

第一次同步后, 重新运行 bee sync 在同一输出目录上是 递增:它只重排日常摘要,谈话,和 自上次行动以来,人们的洞察力有所改变, 因为他们是小的。 同步状态被跟踪于 a .bee-sync.json 显示 输出目录内; 删除它( 或目录) 以强制完整 复作是语.

选项

输出结构

bee-sync/
├── facts.md              # All facts (confirmed and pending)
├── todos.md              # All todos (open and completed)
├── daily/
│   └── YYYY-MM-DD/       # One folder per day
│       └── summary.md    # Daily summary
├── conversations/
│   └── YYYY-MM-DD/       # One folder per day
│       ├── 123.md        # Individual conversation files
│       ├── 456.md
│       └── ...
└── insights/
    └── YYYY-MM-DD/       # One folder per day the insight was generated
        └── 789.md        # Individual insight files

文件格式

事实

包含您的所有事实 由确认身份.

# Facts

## Confirmed

- Fact text here [tag1, tag2] (2024-01-15T10:30:00.000Z, id 42)
- Another fact (2024-01-14T08:00:00.000Z, id 41)

## Pending

- Unconfirmed fact (2024-01-16T12:00:00.000Z, id 43)

每个事实条目包括:

• 事实文本
• 括号中的标记(如果有)
• ISO 8601格式的创建时间戳
• 独一无二的事实 ID

待办事宜

包含您按完成状态排列的所有待办事宜 .

# Todos

## Open

- Buy groceries (id 10, created 2024-01-15T09:00:00.000Z, alarm 2024-01-16T18:00:00.000Z)
- Call dentist (id 11, created 2024-01-15T10:00:00.000Z)

## Completed

- Finish report (id 9, created 2024-01-14T08:00:00.000Z)

每个待办事宜条目包括:

• 待办文本
• 唯一待办事宜 ID
• 创建时间戳
• 提醒时间( 如果设置)

每日/YYY-MM-DD/摘要.md

每日摘要,载有当天的概况.

# Daily Summary — 2024-01-15

- id: 100
- date_time: 2024-01-15T00:00:00.000Z
- created_at: 2024-01-16T02:00:00.000Z
- conversations_count: 5

## Short Summary

Brief overview of the day's activities.

## Summary

Detailed summary of conversations and events.

## Email Summary

Summary of email activity (if available).

## Calendar Summary

Summary of calendar events (if available).

## Locations

- 123 Main St, City (37.77490, -122.41940)
- Coffee Shop (37.78500, -122.40900)

## Conversations

- 123 (2024-01-15T09:00:00.000Z - 2024-01-15T09:30:00.000Z) — Meeting with team
- 124 (2024-01-15T14:00:00.000Z - 2024-01-15T14:15:00.000Z) — Quick chat

对话/YYYY-MM-DD/ID.md

个人谈话记录 详细内容.

# Conversation 123

- start_time: 2024-01-15T09:00:00.000Z
- end_time: 2024-01-15T09:30:00.000Z
- device_type: ios
- state: processed
- created_at: 2024-01-15T09:00:00.000Z
- updated_at: 2024-01-15T10:00:00.000Z

## Short Summary

Brief description of the conversation.

## Summary

Detailed summary of what was discussed.

## Primary Location

- 123 Main St, City (37.77490, -122.41940)
- created_at: 2024-01-15T09:00:00.000Z

## Suggested Links

- https://example.com/resource (2024-01-15T09:15:00.000Z)

## Transcriptions

### Transcription 456
- realtime: false

- Speaker 1: Hello, how are you?
- Speaker 2: I'm doing well, thanks!

每个对话文件包括:

• 元数据( 时间戳、 设备类型、 状态)
• 简短和详细摘要
• 坐标为主位置
• 从谈话中提取的建议链接
• 带有扬声器标签的全文复制

见解/YYY-MM-DD/ID.md

个人见解 蜜蜂为你而生.

# Insight 789 — Morning focus blocks

- id: 789
- generated_at: 2024-01-15T16:00:00.000Z

## Description

You do your deepest work before 11am on days without early meetings.

## Suggested Actions

- Block 9-11am for focused work on Tuesdays and Thursdays.

无法同步显示您在应用程序中被解职或标记不准确 。 A 类 ## Corrections 一节在有更正之处时添加.

实例

同步到默认目录 :

bee sync

同步到自定义目录 :

bee sync --output ~/Documents/bee-backup

只同步特定数据 :

bee sync --only facts,todos

将每日摘要和谈话限制在过去7天:

bee sync --recent-days 7

页:1

• 第一个同步( 或 --full收集一切; 事实和待办事情总是被完全重提
• 重复运行是渐进的:只有每日的总结、谈话和自上次运行以来变化的洞察力被重新绘制,通过运行跟踪 .bee-sync.json 在输出目录中显示
• 对话与每日摘要同时取取,以更快同步
• 所有时间戳都采用ISO 8601格式(UTC)
• 输出目录如果不存在则创建
• 已更改项目的现有文件已覆盖; 删除内容未对齐, 因此服务器上后来删除的项目的本地文件将保留到 --full 重新同步到新目录

许可证

麻省理工学院