Skip to main content
The BananaSplit CLI gives you full access to expense tracking from any terminal. It works for both human users and shell-enabled AI agents.

​
What you can do

  • Track expenses — add, edit, list, and delete expenses across groups and friends
  • Record payments — log settlements between people
  • Check balances — see what you owe and what’s owed to you
  • Manage groups — create groups, add members, configure splits
  • Browse activity — search expenses, view history, explore spending

​
How it works

The CLI authenticates through your browser using device approval. No passwords or API tokens to manage. Once signed in, credentials are stored securely:
  • macOS — system keychain
  • Linux / Windows — encrypted file at ~/.local/share/banana/credentials.json
Data syncs with the BananaSplit iOS, Android, and web apps.

​
Output formats

Commands print human-readable output by default. Use --json for structured output (ideal for agents) or --raw for the complete API response.

​
Naming things

Currencies, groups, and people can be referenced by name, code, or prefix:
Ambiguous names are reported rather than guessed.

Installation

Install on macOS, Linux, or Windows.

Authentication

How login and credential storage work.

Commands

Full command reference with examples.

Output formats

JSON, raw, and human-readable output.