圆背 CLI
搜索和访问您的会议、记录誊本、电子邮件、日历活动以及终端上的其他活动,并管理您的动作项目、标签、文件夹和会议访问.
安装
npm install -g @circleback/cli
需要节点.js 18或以后。 软件包安装了两个二进制: circleback 财务报告和审定财务报表 cb (快手语.
快开始
# Log in with your browser
cb auth login
# Search recent meetings
cb meetings
# Search by keyword
cb meetings "product review"
# Read by ID (from the meeting URL, e.g. circleback.ai/meetings/abc123)
cb meetings read abc123
# Search transcripts
cb transcripts "pricing discussion"
# Search emails
cb emails "from:[email protected] after:2026-01-01"
# Mark an action item done
cb action-items update 123 --status DONE
# Get raw JSON for scripting
cb meetings --json
图标
| 命令 | 说明 |
|---|---|
cb auth login | 用浏览器登录到 Circleback |
cb auth login --api-key | 登录 API 密钥 |
cb auth logout | 在此设备上签名 |
cb update | 更新 CLI 到最新版本 |
cb meetings [search] | 搜索会议 |
cb meetings read <ids...> | 详细阅读会议信息、说明和行动项目(最多50个) |
cb meetings update <id> | 更新会议 |
cb meetings share <id> | 共享会话或删除访问 |
cb transcripts <search> | 搜索记录内容 |
cb transcripts read <ids...> | 全文阅读(最多50份) |
cb calendar | 搜索日历事件 |
cb calendar update <id> | 更新日历事件 |
cb people <names...> | 搜索人们的名字 |
cb companies <terms...> | 搜索公司名称或域名 |
cb emails [search] | 搜索连接的电子邮件账户 |
cb support [search] | 搜索回转支持文章 |
cb action-items [search] | 搜索动作项目 |
cb action-items create <title> | 创建动作项目 |
cb action-items update <id> | 更新一个行动项目 |
cb action-items delete <id> | 删除动作项目 |
cb teams | 列出您的工作空间和团队 |
cb tags | 列表标签 |
cb tags create <name> | 创建标签 |
cb tags update <id> | 更新标签 |
cb tags delete <id> | 删除标签 |
cb folders | 列表文件夹 |
cb folders read <ids...> | 读取文件夹 |
cb folders create <name> | 创建文件夹 |
cb folders update <id> | 更新文件夹 |
cb folders delete <id> | 删除文件夹 |
cb folders share <id> | 共享文件夹 |
运行 cb --help 或者说 cb <command> --help 完全使用细节.
会议标识符
cb meetings read 财务报告和审定财务报表 cb transcripts read 接受最多50个会面身份证.
过滤
会议、记录和日历搜索支持按日期范围过滤。 通过标签、个人和公司进行过滤:
cb meetings --tags 1,2 --profiles 42 --domains acme.com
cb meetings --last 30 # Last 30 days
cb meetings --from 2026-01-01 --to 2026-03-01
cb calendar --last 7 # Next 7 days of events
电子邮件搜索支持内置过滤语法 :
cb emails "from:[email protected]"
cb emails "to:[email protected] after:2026-01-01"
cb emails "participant:[email protected] before:2026-06-01"
JSON 输出
过 --json 以获取原始 JSON 而非格式化表格。 用于管道 jq 或与其他工具相融合:
cb meetings "standup" --json | jq '.[].name'
登录
cb auth login # Opens your browser to log in
cb auth login --api-key # Asks for your API key securely
cb auth logout # Signs out on this device
API 密钥登录链接到 设置 ~ API 密钥,验证密钥,并将其保存在您的设备上.
对于无国籍的自动化,设置 CIRCLEBACK_API_KEY 而不是登录在 :
CIRCLEBACK_API_KEY=cb_your_api_key cb meetings --json
更改会议、动作项目、标签、文件夹或共享权限需要写入权限。 浏览器在v0.5.0 之前登录, 不包含它, 所以运行 cb auth login ; 只读的 API 密钥无法更改 .
限于一个文件夹的 API 密钥只到达文件夹的会议、记录和动作项目,所以 cb --help 仅列出可以运行的命令.
CIRCLEBACK_API_KEY 优先于存储的证书。 运行前取消它 cb auth login· ; cb auth logout 无法从外壳中清除环境变量.
探员
CLI旨在与AI代理和工具使用系统良好地合作:
- 每个命令都接受
--json用于结构化、可解析的产出 - 命令跟随一致
<resource> <action>模式 - 所有选项都有长式名称以明确
- 错误消息包括可操作指令
- 退出代码遵循标准惯例(0=成功,1=出错)