01 Instale a CLI
curl -fsSL https://github.com/teotti/banana-cli/releases/latest/download/install.sh | shBinário independente. Não precisa de Node nem de Bun. Os instaladores obtêm a versão estável mais recente para seu sistema.
O BananaSplit para agentes
Despesas compartilhadas,
agora com agentes
Sua turma. Seus planos. Seu agente cuida da divisão.
Mostre a CLI ao seu agente favorito e coloque-o para trabalhar.
Claude, Codex, Grok Bot, OpenClaw, Hermes. Todos são bem-vindos.
Para pessoas e agentes com acesso ao terminal.
████ ███ █ █ ███ █ █ ███ ████ ████ █ █████ █████ █ █ █ █ ██ █ █ █ ██ █ █ █ █ █ █ █ █ █ ████ █████ █ █ █ █████ █ █ █ █████ ███ ████ █ █ █ █ █ █ █ █ ██ █ █ █ ██ █ █ █ █ █ █ █ ████ █ █ █ █ █ █ █ █ █ █ ████ █ █████ █████ █
Obter a versão mais recente — 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 / Conecte-se
Começar
Do zero ao
“começar a registrar despesas”
Uma instalação. Sua conta no BananaSplit.
Uma tarefa a menos na sua vida.
02 Entre na sua conta
banana loginEntre na sua conta do BananaSplit no navegador e confirme que o código é o mesmo. Em uma máquina sem interface gráfica, abra a URL exibida em outro dispositivo.
03 Dê contexto ao seu agente
Use a CLI do BananaSplit para me ajudar a gerenciar despesas compartilhadas. Leia https://github.com/teotti/banana-cli e execute banana --help para começar.
Seu agente precisa de acesso ao terminal onde a CLI está instalada e com sessão iniciada. Execute banana update para manter tudo atualizado.
02 / Coloque para trabalhar
Mais vida. Menos contas.
O jantar acabou. As contas também.
“Adicione o jantar de hoje de €60 à nossa viagem a Lisboa. Eu paguei. Divida igualmente comigo, Alex e Sam.”
Ver o comando da 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=20Descubra para onde foi o dinheiro.
“Mostre minhas dez maiores despesas. Vamos ver o que pesa mais.”
Ver o comando da CLI
banana expenses list --sort amount --direction desc --limit 10 --jsonAcompanhe as contas do dia a dia.
“Encontre minhas despesas recorrentes e me ajude a revisar o que vem por aí.”
Ver o comando da CLI
banana expenses list --recurring --sort date --direction asc --jsonOs comandos de exemplo usam IDs fictícios. Seu agente pode consultar os IDs reais com banana me, banana currencies, banana groups, e banana groups members GROUP_ID.
Feito para seu terminal.
Pensado para sua vida.
Resultados legíveis para você. JSON estruturado para seu agente.
O mesmo BananaSplit. Um novo jeito de dividir.