BananaSplit para agentes

Gastos compartidos,
ahora con agentes

Tu gente. Tus planes. Tu agente se encarga de las cuentas.

Dale la CLI a tu agente favorito y ponlo a trabajar. Claude, Codex, Grok Bot, OpenClaw, Hermes. Todos son bienvenidos.

Para personas y agentes con acceso al terminal.

banana --help

Obtener la última versión — 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> --json

01 / Conéctate

Primeros pasos

De cero a
«empezar a registrar gastos»

Una instalación. Tu cuenta de BananaSplit.
Una tarea menos en tu vida.

Obtener la última versión

01 Instala la CLI

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

Binario independiente. No necesitas Node ni Bun. Los instaladores descargan la última versión estable para tu sistema.

02 Entra en tu cuenta

banana login

Inicia sesión en tu cuenta de BananaSplit en el navegador y confirma que el código coincide. En un equipo sin interfaz gráfica, abre la URL indicada en otro dispositivo.

03 Dale contexto a tu agente

Usa la CLI de BananaSplit para ayudarme a gestionar gastos compartidos. Lee https://github.com/teotti/banana-cli y ejecuta banana --help para empezar.

Tu agente necesita acceso al terminal donde la CLI está instalada y tiene la sesión iniciada. Ejecuta banana update para mantenerla al día.

02 / Ponlo a trabajar

Más vida. Menos cuentas.

01 / Registrar

La cena terminó. Las cuentas también.

Añade la cena de hoy de 60 € a nuestro viaje a Lisboa. Pagué yo. Divídela a partes iguales entre Alex, Sam y yo.

Ver el comando de la CLI
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=20
02 / Explorar

Descubre adónde fue el dinero.

Muéstrame mis diez gastos más grandes. Veamos qué se lleva la mayor parte.

Ver el comando de la CLI
banana expenses list --sort amount --direction desc --limit 10 --json
03 / Revisar

Sigue las cuentas del día a día.

Busca mis gastos recurrentes y ayúdame a revisar lo que viene.

Ver el comando de la CLI
banana expenses list --recurring --sort date --direction asc --json

Los comandos de ejemplo usan IDs ficticios. Tu agente puede consultar los IDs reales con banana me, banana currencies, banana groups, y banana groups members GROUP_ID.

Para tu terminal.
Pensado para tu vida.

Resultados claros para ti. JSON estructurado para tu agente.
El mismo BananaSplit. Una nueva forma de dividir.

Explorar la CLI Consultar los comandos