CLI 安装与连接
安装 busabase-cli，登录、选择工作区，并完成第一次只读验证。
使用 busabase-cli 在终端操作 Busabase，也适合 Agent 脚本和 CI。它与 SDK、OpenAPI 接入 使用同一套 REST API。
安装
CLI 软件包要求 Node.js 24.18.0 或更高版本。
npm install -g busabase-cli
busabase-cli --help不想全局安装，也可以先运行：
npx busabase-cli --help登录 Cloud
busabase-cli login --device-code打开终端显示的授权地址，在浏览器里批准连接。选择或创建符合任务需要的 API 密钥，下面的检查只需要 read 权限。CLI 会将连接信息保存到 ~/.busabase/.env。
CI 或其他非交互环境可以通过环境变量提供 BUSABASE_BASE_URL、BUSABASE_API_KEY 和 BUSABASE_SPACE_ID。密钥和权限说明见 API 密钥。
选择工作区并验证
busabase-cli whoami
busabase-cli space list
busabase-cli space use "Marketing"
busabase-cli bases list --output json将 Marketing 换成你的工作区名称、slug 或 id。先确认目标工作区，再继续操作。这些检查只读取已有数据，不创建或合并修改。需要多个账户时，阅读 CLI 账户与工作区。
连接本地 / Desktop
先在这台电脑上启动 Busabase，然后运行：
busabase-cli login --base-url http://localhost:15419
busabase-cli health
busabase-cli bases list开源本地服务默认不需要认证。连接私有化部署时，运行 busabase-cli login，选择对应的私有化连接方式并填写团队的服务地址。
让 Agent 继续工作
busabase-cli skill
busabase-cli skill install第一条命令显示操作指南，第二条将指南安装到 Agent 的 skills 目录。详见 Agent Skills。需要修改数据时，通过 Change Requests 提出修改，并按照工作区权限进行审核。
其他接入方式：接入方式总览 · CLI · SDK · MCP · OpenAPI / REST · Agent Skills · Webhook