01 Install the CLI
curl -fsSL https://github.com/teotti/banana-cli/releases/latest/download/install.sh | shStandalone binary. No Node or Bun required. Installers fetch the latest stable version for your system.
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.
For people and agents with shell access.
████ ███ █ █ ███ █ █ ███ ████ ████ █ █████ █████ █ █ █ █ ██ █ █ █ ██ █ █ █ █ █ █ █ █ █ ████ █████ █ █ █ █████ █ █ █ █████ ███ ████ █ █ █ █ █ █ █ █ ██ █ █ █ ██ █ █ █ █ █ █ █ ████ █ █ █ █ █ █ █ █ █ █ ████ █ █████ █████ █
Get the latest release — Split expenses, settle balances, and manage groups on BananaSplit from your terminal.
USAGE
banana <command> [--json | --raw]
BALANCES
balance Show the aggregate balance
balance users Show balances by user
balances Alias for `balance users`
EXPENSES & PAYMENTS
expenses list List the authenticated user's expenses
expenses add Add an expense
expenses get <expense-id> Show an expense
expenses edit <expense-id> Edit an expense
payments add Add a payment
payments get <payment-id> Show a payment
GROUPS & FRIENDS
groups [list] List groups
groups create Create a group
groups get <group> Show a group
groups members <group> List group members
groups activities <group> List group activities
friends [list] List friends
currencies [list] List currencies
ACCOUNT & CLI
me Show the authenticated user
login Sign in with a browser and store credentials securely
logout Revoke and delete stored credentials
update Update the CLI to the latest stable release
OUTPUT
--json Print curated operational JSON
--raw Print the complete API response as JSON
ENVIRONMENT
BANANASPLIT_API_URL API base URL (default: https://api.bananasplit.net)
BANANASPLIT_AUTH_URL Auth base URL (default: API origin + /api)
Currencies, groups and people are named by code, name or prefix wherever a
command takes one — ids work too, and `me` is you.
EXAMPLES
banana balance
banana expenses list --limit 10
banana expenses add --title Dinner --amount 42 --currency EUR \
--date 2026-09-09 --group "Lisbon trip"
banana expenses get <expense-id> --json01 / Get connected
Quick start
From zero to
“start tracking expenses”
One install. Your BananaSplit account.
A little less admin in your life.
02 Make yourself at home
banana loginSign in to your BananaSplit account in the browser and approve the matching code. On a headless machine, open the printed URL on another device.
03 Give your agent the context
Use the BananaSplit CLI to help me manage shared expenses. Read https://github.com/teotti/banana-cli and run banana --help to get started.
Your agent needs shell access where the CLI is installed and signed in. Run banana update anytime to stay up to date.
02 / Put it to work
Real life. Less bookkeeping.
Dinner’s done. So are the splits.
“Add tonight’s €60 dinner to our Lisbon trip. I paid. Split it equally with Alex and Sam.”
See the CLI command
banana expenses add --title "Dinner" --amount 60 \
--currency-id CURRENCY_ID --paid-by-id YOUR_ID \
--date 2026-09-16 --group-id GROUP_ID \
--split-type equal --split YOUR_ID=20 \
--split ALEX_ID=20 --split SAM_ID=20Find where the money went.
“Show me my ten biggest expenses. Let’s see what’s taking the biggest bite.”
See the CLI command
banana expenses list --sort amount --direction desc --limit 10 --jsonKeep up with the everyday.
“Find my recurring expenses and help me review what’s coming up.”
See the CLI command
banana expenses list --recurring --sort date --direction asc --jsonCommand examples use placeholder IDs. Your agent can look up real IDs with banana me, banana currencies, banana groups, and banana groups members GROUP_ID.
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.