BananaSplit CLI for Agents Skill 技能

技能简介

BananaSplit CLI 是面向 AI Agent 的费用追踪 skill，让 Claude Code、Codex、Cursor、Gemini CLI、OpenClaw、Grok、Hermes 等 Agent 都能在终端里替你记账：添加开销、查看余额、记录收款、按群组拆分。它把 BananaSplit 移动端/Web 端的账户能力暴露为单一可调用的 CLI skill，人类看到的是可读输出，Agent 拿到的是结构化 JSON。一次安装，一次登录，Agent 立刻学会使用真实的人名、解析 JSON、做均分与按人分账、记录付款。

核心能力

1. 一行安装即用：npx skills add teotti/banana-cli --skill banana --global，会自动给 Agent 安装 CLI 并引导登录。
2. 人类/Agent 双格式输出：默认输出可读终端视图，加 --json 输出面向 Agent 的精简运营 JSON，加 --raw 输出完整 API 响应。
3. 多支付场景：支持普通支出、循环订阅、按群组拆分（均分/按人/按比例）、余额查询、活动记录、付款登记。
4. 多 Agent 平台：兼容 Claude Code、Codex、Cursor、Gemini CLI、opencode、Grok Bot、Hermes、OpenClaw 等任何具备 shell 访问能力的 Agent。
5. 跨端数据同步：CLI 与 iOS/Android/Web 应用共用同一 BananaSplit 账户，群组、余额、支出、付款实时一致。
6. 自检与升级：内置 banana doctor（检查 CLI、登录、Skill 状态）与 banana upgrade（保持最新版本）。
7. 可信分发：原生 macOS/Linux/Windows 二进制在替换前自动校验 SHA-256，无需依赖 Node/Bun 也能运行。

安装配置

1. 通过 npm/Bun/pnpm 全局安装 CLI：npm install -g @bananasplitapp/cli 或 bun install -g @bananasplitapp/cli，也可一键 curl 安装脚本。
2. 用 npx skills add teotti/banana-cli --skill banana --global 把 skill 注入到目标 Agent，新开会话后生效。
3. 已装 CLI 的用户可直接 banana skill install，自动覆盖 Claude Code、Codex、Cursor、Gemini CLI、opencode。

使用步骤

1. 在终端运行 banana login，浏览器打开授权页确认配对码；无头机器可用另一台设备打开 URL 完成。
2. 让 Agent 发起任务，例如"用 BananaSplit 查一下我的余额"。
3. 添加一笔支出：banana expenses add --title Dinner --amount 60 --currency EUR --paid-by me --group "Lisbon trip" --split-type equal --split me=20 --split Alex=20 --split Sam=20。
4. 查询活动：banana expenses list --sort amount --direction desc --limit 10 --json（加 --json 给 Agent）。
5. 订阅/循环支出回顾：banana expenses list --recurring --sort date --direction asc --json。

适用场景

1. 旅行/活动均摊：与朋友、同事出游时，让 Agent 记下每笔 AA 付款并自动按人拆分。
2. 情侣/室友共账：用群组记录房租、餐费、订阅服务，按比例或均分后自动算清当月该付多少。
3. 团队差旅报销：把差旅支出放进专门群组，Agent 帮你按金额/日期/类别筛选待报销条目。
4. 订阅管理：用循环支出自动捕获每月会员费，定时回顾"哪些订阅忘了取消"。
5. Agent 自身记账：让 OpenClaw/Claude 等 Agent 在执行真实任务时自动登记产生的 API 费用、外包开支。

适用人群

需要在终端/CLI 里集中记账的开发者、经常和朋友/同事均摊费用的用户、用 AI Agent 自动化日常事务的极客，以及想把"开销数据"和"对话上下文"打通的团队。

工作原理

BananaSplit CLI 是一个独立的本地二进制（macOS/Linux/Windows），通过 HTTPS 与 BananaSplit 后端 API 通信，对人类输出可读文本、对 Agent 输出 JSON 字段。skill 安装命令会把 CLI 与一组 prompt 模板注册到目标 Agent 的指令系统，让 Agent 在收到"花销、AA、记账、付款"等关键词时自动调用对应子命令。CLI 不常驻内存，按需调用；本地不保存账本，账户状态完全在云端，因此多设备、多 Agent 实例天然共享同一份数据。

官方链接

• Skill/Agent 入口：https://bananasplit.net/en/agents/
• GitHub：https://github.com/teotti/banana-cli
• 移动端/Web 应用：https://bananasplit.net/