01 Instala a CLI
curl -fsSL https://github.com/teotti/banana-cli/releases/latest/download/install.sh | shBinário autónomo. Não precisas de Node nem de Bun. Os instaladores obtêm a versão estável mais recente para o teu sistema.
O BananaSplit para agentes
Despesas partilhadas,
agora com agentes
A tua malta. Os teus planos. O teu agente trata das contas.
Mostra a CLI ao teu agente de eleição e põe-no a 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 / Liga-te
Começar
Do zero ao
«começar a registar despesas»
Uma instalação. A tua conta no BananaSplit.
Menos uma tarefa na tua vida.
02 Entra na tua conta
banana loginInicia sessão na tua conta do BananaSplit no navegador e confirma que o código coincide. Numa máquina sem interface gráfica, abre o URL apresentado noutro dispositivo.
03 Dá contexto ao teu agente
Usa a CLI do BananaSplit para me ajudar a gerir despesas partilhadas. Lê https://github.com/teotti/banana-cli e executa banana --help para começar.
O teu agente precisa de acesso ao terminal onde a CLI está instalada e tem sessão iniciada. Executa banana update para manteres tudo atualizado.
02 / Põe-no a trabalhar
Mais vida. Menos contas.
O jantar acabou. As contas também.
“Adiciona o jantar de hoje de 60 € à nossa viagem a Lisboa. Paguei eu. Divide por igual 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=20Descobre para onde foi o dinheiro.
“Mostra-me as minhas dez maiores despesas. Vamos ver o que pesa mais.”
Ver o comando da CLI
banana expenses list --sort amount --direction desc --limit 10 --jsonAcompanha as contas do dia a dia.
“Encontra as minhas despesas recorrentes e ajuda-me a rever o que aí vem.”
Ver o comando da CLI
banana expenses list --recurring --sort date --direction asc --jsonOs comandos de exemplo usam IDs fictícios. O teu agente pode consultar os IDs reais com banana me, banana currencies, banana groups, e banana groups members GROUP_ID.
Feito para o teu terminal.
Pensado para a tua vida.
Resultados legíveis para ti. JSON estruturado para o teu agente.
O mesmo BananaSplit. Uma nova forma de dividir.