Bookipi

Bookipi CLI

通过用通俗英语向 Claude 提问，或使用 --json 命令编写自己的代码，即可处理后台事务——发票、付款、客户、支出、提案、合同和报告。

任何会发送邮件、记录付款或发布内容的操作，都会先等待你确认；Bookipi 绝不会转移资金。概览：bookipi.com/cli。

目录

1. 使用方式
2. 安装技能 — Claude Desktop 和 Cowork · Claude Code · Codex · Gemini CLI · 其他 Agent
3. 允许网络访问（Cowork）
4. 登录和工作区
5. 可以尝试的提问
6. 基于 CLI 构建 — 命令
7. 帮助和错误报告
8. 隐私
9. 许可证

使用方式

你想要……	使用
向 Claude 提问（Cowork、Claude Desktop、Claude Code、Codex、Gemini CLI）	技能——其中包含 CLI
在 claude.ai 或任何 MCP 客户端中使用 Bookipi，无需安装	Bookipi 连接器——也可在 MCP Registry 中找到，名称为 io.github.Bookipi-Group/bookipi
编写脚本，或将其集成到自己的 Agent 和产品中	CLI

所有选项底层使用的都是同一款工具。

安装技能

该技能包含 Bookipi CLI，因此无需额外安装。在自己的电脑上运行时（Claude Code、Codex、Gemini CLI），需要 Node 22.12+；首次使用时还会将 bookipi 命令添加到 ~/.local/bin，方便你自行运行。

Claude Desktop 和 Cowork

1. 从最新版本下载 bookipi-cli.skill。
2. 双击并确认。它会以 bookipi-cli 的名称显示在技能列表中。

没有反应？将文件拖入 Cowork 窗口。如果浏览器移除了 .skill 扩展名，请先将其改回。

Claude Code

/plugin marketplace add Bookipi-Group/bookipi-cli
/plugin install bookipi@bookipi-cli

要升级，请先刷新 marketplace，然后再更新（保留 @bookipi-cli 部分，否则会出现“Plugin not found”）：

/plugin marketplace update bookipi-cli
/plugin update bookipi@bookipi-cli

在 Claude Desktop 中安装的技能，也可用于从桌面应用启动的 Claude Code 会话。若要手动安装，请将 .skill 文件解压到 ~/.claude/skills/。

Codex

/plugin marketplace add Bookipi-Group/bookipi-cli
/plugin install bookipi

Gemini CLI

gemini extensions install https://github.com/Bookipi-Group/bookipi-cli

使用 gemini extensions update bookipi 升级。此扩展还包含 Bookipi 连接器：运行一次 /mcp auth bookipi 即可登录，之后技能会使用连接器而非 CLI。

其他 Agent

对于 Cursor、GitHub Copilot、Antigravity、Windsurf 以及其他可读取技能的 Agent，请使用 skills CLI 安装：

npx skills add Bookipi-Group/bookipi-cli --skill bookipi-cli

使用 npx skills update bookipi-cli 升级。也可以手动将此仓库中的 .agents/skills/bookipi-cli/ 复制到项目或 Agent 的技能文件夹中。

允许网络访问（Cowork）

在 Claude Code 中，或工作区管理员已添加以下域名时，跳过此步骤。

Cowork 在会屏蔽未知网站的沙盒中运行，因此 Bookipi 必须列入组织的允许列表，否则登录会失败。管理员可在以下位置添加这些域名： Organization Settings → Capabilities → Code execution → Additional allowed domains：

*.bkpi.co
*.bookipi.com
*.bookipay.com
*.s3.amazonaws.com
*.amplitude.com

前三个域名是 Bookipi 的服务器；S3 用于上传收据和显示发票预览中的图片。如果缺少某个域名，Claude 会在首次请求时告知，并列出这些域名——请转发给管理员。

登录和工作区

每个 Bookipi 工作区都是电脑上的一个文件夹。登录信息保存在该文件夹的 .bookipi/ 中（已加入 git 忽略），因此在该文件夹中的每个会话都会保持登录状态。

1. **Cowork：**新建项目 → 使用文件夹 → 选择一个文件夹。 **Claude Code：**在任意文件夹中启动 claude。
2. 提示：“在此文件夹中设置 Bookipi。”Claude 会提供登录链接。
3. 通过以下提示检查：“我当前以哪个账号登录？”

如需使用另一个 Bookipi 账号，请改用另一个文件夹。

不关联文件夹的 Cowork 项目仅存于云端，并会在聊天之间清除，因此每次都需要重新登录。请关联一个文件夹，或使用 Bookipi connector，这样登录信息会保存在你的 Claude 账号中。

在 Claude Code 中，文件夹是可选的：只需说“帮我登录 Bookipi”，登录信息就会保存到 ~/.bookipi/，可用于你电脑上的所有文件夹。

可以尝试的提问

	试试看
欠款	“谁欠我钱？” · “显示逾期发票。” · “给所有逾期发票发送提醒。”
发票	“为 Acme 创建一张发票——咨询服务费 $5,000。” · “给我看看 INV-650 的样子。” · “将 INV-650 发送给 [email protected]。” · “将 INV-650 标记为已付款。”
客户	“调出 Wayne Construction。” · “添加新客户：Acme Corp，[email protected]。” · “给 Maria 发邮件——告诉她我会晚些参加通话。”
交易和提案	“添加一笔交易——Stark 厨房翻新，$40,000。” · “为 Stark 交易起草一份提案。” · “将 Stark 交易标记为已成交。”
合同	“将那份已接受的提案转为合同。” · “把 MSA 发送给 Bruce。” · “Bruce 签署了吗？”
费用	上传一张收据：“将其记录为一笔费用。” · “显示我本月的费用。”
报告	“给我一份晨间简报。” · “本季度我的最大客户是谁？” · “为上一季度创建一个仪表板。”
日历	“我今天的日历上有什么安排？” · “查找我本周与 Maria 的会议。”
账号	“我有哪些公司？” · “切换到我的另一个 Bookipi 账号。” · “让我退出登录。”

使用 CLI 构建

面向 JSON 的命令行工具，可用于脚本、自动化和自建 Agent。 需要 Node 22.12+，无需构建步骤。

安装（macOS/Linux）：从最新发布页面运行单行安装程序。它会验证下载内容，将程序安装到 ~/.local/share/bookipi-cli，并将 bookipi 添加到 ~/.local/bin。它不会安装 Node，也不会修改 shell 配置文件。再次运行即可更新。

或者从克隆的仓库中运行——生产构建位于 skills/bookipi-cli/bin/bookipi.js：

git clone https://github.com/Bookipi-Group/bookipi-cli.git ~/bookipi-cli
alias bookipi=~/bookipi-cli/skills/bookipi-cli/bin/bookipi.js

使用：

bookipi init                                   # create a workspace and sign in
bookipi invoice list --status overdue --json   # structured output

在 CI 或无头环境中使用时，请设置 BOOKIPI_TOKEN，无需登录。可直接使用的脚本（追踪逾期发票、每周向 Slack 发送摘要、将收据文件夹中的收据记为费用）位于 examples/ 中。

命令

每条命令都接受 --json；bookipi <group> --help 会列出各项标志。

分组	涵盖内容	子命令
invoice	发票及相关文档	list get preview create create-from-proposal duplicate update delete send send-receipt mark-paid void remind collections attach-photo
customer	客户、付款、电子邮件	list get payments create update delete send-email emails
item	产品和服务	list create set-photo
expense	费用和收据扫描	categories list upload scan create delete
paylink	BPay 付款链接	create list get status send
deal	销售管道交易	list create update
proposal	AI 撰写的提案	list generate update duplicate send delete
contract	电子签名合同	list draft upload create-from-proposal finalize send
report	报告、仪表板、洞察	summary customers items dashboard insights digest suggest open
meeting	录制的会议和预订	list
calendar	日历连接	status
company	当前公司	list set
website	AI 构建的公司网站	status content pages page create generate add-page update ask preview publish analytics open
—	会话和工作区	setup login logout whoami init mcp

bookipi setup 是 Agent 的首个调用：它会检查登录状态，在需要时启动登录流程，并以 JSON 返回下一步操作。

发送电子邮件、记录或清除付款、创建或发送付款链接，或发布网站的命令，若未指定 --yes，将拒绝运行。在聊天中，Claude 会先征求你的同意；在脚本中，请自行传入 --yes。

帮助和错误报告

请提交 GitHub issue，说明你提出了什么要求、Claude 做了什么，以及你预期会发生什么。

**安全问题：**请私下报告——参见 SECURITY.md。

隐私

Bookipi CLI 使用你自己的 Bookipi 账户。完整政策： bookipi.com/privacy-policy。

• 业务数据（发票、客户、费用、交易、提案、合同、会议、网站）通过 HTTPS 从你的 Bookipi 账户读取并写入其中，不会传到其他地方。
• 登录令牌保存在你的设备上，位于工作区的 .bookipi/ 或 ~/.bookipi/ 中，只有你可以读取。令牌只会发送至 Bookipi 的登录服务；bookipi logout 会将其删除。
• 收据和徽标图片会上传至 Bookipi 的 S3 存储，用于扫描和发票预览。
• 使用情况分析数据会发送至 Amplitude：运行了哪条命令、耗时、是否失败，以及 CLI 版本、操作系统和客户端。系统通过你的电子邮件或设备的单向哈希值识别你；绝不会发送命令参数、发票内容、客户记录或凭据。设置 BOOKIPI_NO_ANALYTICS=1 或 DO_NOT_TRACK=1 可关闭此功能。
• **更新检查：**CLI 每天会向 GitHub 查询最新版本，只发送自身版本号。设置 BOOKIPI_NO_UPDATE_CHECK=1 可关闭此功能。

它不会扫描你的文件（只会访问工作区文件夹以及你指定的文件），不会收集你与 Claude 的对话，也不会将数据用于广告或模型训练。业务数据遵循 Bookipi 的保留政策；本地登录状态会一直保留，直到你退出登录。

如有疑问或需要删除数据，请联系：[email protected]。

许可证

版权所有 © Bookipi。保留所有权利——参见 LICENSE。使用须遵守 Bookipi 的服务条款。