Enter app

BananaSplit for agents

The expense tracking
layer for agents

Your people. Your plans. Your agent handles the splits.

Point your agent of choice at the CLI and put it to work. Claude, Codex, Grok Bot, OpenClaw, Hermes. All are welcome.

View on GitHub Quick start

For people and agents with shell access.

Add expense "Meat" 120.34€ yesterday on BBQ Legends group

Skill(banana)

Successfully loaded skill

Ran 2 shell commands

$ banana expenses add --title Meat --amount 120.34 \
  --currency EUR --group "BBQ Legends" --date 2026-09-20

Added Meat — €120.34, 2026-09-20, group BBQ Legends, paid by you.

Split equally three ways (€40.11 each): Diogo Ferreira, Paulo, Cláudia.

Accomplishing for 5s · done

Shared expensesGroups & friendsBalances & paymentsJSON output

01 / Get connected

Quick start

From zero to
“start tracking expenses”

One install. Your BananaSplit account.
A little less admin in your life.

Get the latest release

01 Install the skill

npx skills add teotti/banana-cli --skill banana --global

Requires Node.js. Choose your agent, then start a new session. The skill installs the Banana CLI for you and walks you through signing in.

Already have the CLI? Run banana skill install instead — it covers Claude Code, Codex, Cursor, Gemini CLI and opencode.

02 Ask your agent

Use BananaSplit to check my balances.

That is all it takes. You complete the browser login yourself, and the skill teaches your agent to use names, parse JSON, split expenses and record payments.

03 Install the CLI yourself

curl -fsSL https://github.com/teotti/banana-cli/releases/latest/download/install.sh | sh

Standalone binary. No Node or Bun required. Downloads are verified against the published SHA-256 checksums before anything is replaced. Installers fetch the latest stable version for your system.

04 Make yourself at home

banana login

Sign in to your BananaSplit account in the browser and approve the matching code. On a headless machine, open the printed URL on another device.

Your agent needs shell access where the CLI is installed and signed in. Run banana upgrade anytime to stay up to date. Something not right? banana doctor checks the CLI, your login and the agent skill.

02 / Put it to work

Let the agents do the bookkeeping.

Track

Say it and it’s logged.

“Add tonight’s €60 dinner to our Lisbon trip. I paid. Split it equally with Alex and Sam.”

  • Add an expense
  • Add a recurring expense
  • Record a payment
See the CLI command
banana expenses add --title Dinner --amount 60 \
  --currency EUR --paid-by me --date 2026-09-16 \
  --group "Lisbon trip" --split-type equal \
  --split me=20 --split Alex=20 --split Sam=20
Explore

Just ask where it went.

“Show me my ten biggest expenses. Let’s see what’s taking the biggest bite.”

  • Check the activity
  • Check the balances
  • See a group’s last ten expenses
See the CLI command
banana expenses list --sort amount --direction desc --limit 10 --json
Review

Look back. Look ahead.

“Find my recurring expenses and help me review what’s coming up.”

  • Upcoming subscriptions
  • Latest activity
  • Edit or delete anything
See the CLI command
banana expenses list --recurring --sort date --direction asc --json

Currencies, groups and people can be named by code, name or a prefix of either wherever a command takes one. Ids still work, ambiguous names are reported rather than guessed, and “me” is you. See what you have with banana groups, banana friends, banana currencies, and banana me.

Everything is manageable through your agent of choice.

03 / Read this first

What agents need to know

The BananaSplit CLI is the expense tracking layer for agents. One skill, one sign-in, and your agent can add expenses, manage groups, check balances, and record payments from the terminal. People get readable output. Agents get structured JSON with --json.

The BananaSplit CLI, invoked as banana, tracks shared expenses from the terminal. It uses the same BananaSplit account as the iOS, Android, and web apps, so groups, balances, expenses, and payments stay in sync.

Run npx skills add teotti/banana-cli --skill banana --global, start a new agent session, and sign in with banana login. You approve a code in the browser. On a headless machine, open the printed URL on another device. If the CLI is already installed, banana skill install covers Claude Code, Codex, Cursor, Gemini CLI, and opencode.

Claude, Codex, Cursor, Gemini, Grok, Hermes, and OpenClaw. Any agent with shell access can run the CLI once it is installed and signed in.

Pass --json for curated operational JSON, or --raw for the complete API response. Leave both flags off when a person wants the readable terminal view.

The skill installer needs Node.js. The CLI itself is a standalone binary for macOS, Linux, and Windows, checked against published SHA-256 checksums before it replaces anything. Bun users can run bun install -g @bananasplitapp/cli.

Built for your terminal.
Made for your life.

Readable output for you. Structured JSON for your agent.
Same BananaSplit. A whole new way to split.

Explore the CLI Read the command reference