Entrar na app

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.

Ver no GitHub Começar

Para pessoas e agentes com acesso ao terminal.
Usas o Claude ou o ChatGPT sem terminal? Liga-te por MCP →
Lê a documentação completa →

Adiciona a despesa "Carne" de 120,34€ de ontem no grupo BBQ Legends

Skill(banana)

Successfully loaded skill

Ran 2 shell commands

$ banana expenses add --title Carne --amount 120.34 \
  --currency EUR --group "BBQ Legends" --date 2026-09-20

Adicionei Carne — 120,34 €, 2026-09-20, grupo BBQ Legends, paga por ti.

Dividida igualmente por três (40,11 € cada): Diogo Ferreira, Paulo, Cláudia.

Accomplishing for 5s · done

Despesas partilhadasGrupos e amigosSaldos e pagamentosResultados em JSON

01 / 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.

Obter a versão mais recente

01 Instala a skill

npx skills add teotti/banana-cli --skill banana --global

Precisa de Node.js. Escolhe o teu agente e abre uma sessão nova. A skill instala a CLI do Banana por ti e guia-te no início de sessão.

Já tens a CLI? Executa banana skill install e fica tudo pronto — cobre o Claude Code, Codex, Cursor, Gemini CLI e opencode.

02 Pede ao teu agente

Usa o BananaSplit para ver os meus saldos.

É só isto. O início de sessão no navegador é contigo, e a skill ensina o teu agente a usar nomes, ler JSON, dividir despesas e registar pagamentos.

03 Instala a CLI tu mesmo

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

Binário autónomo. Não precisas de Node nem de Bun. As transferências são verificadas com as somas SHA-256 publicadas antes de substituir o que quer que seja. Os instaladores obtêm a versão estável mais recente para o teu sistema.

04 Entra na tua conta

banana login

Inicia 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.

O teu agente precisa de acesso ao terminal onde a CLI está instalada e tem sessão iniciada. Executa banana upgrade para manteres tudo atualizado. Algo não está bem? banana doctor verifica a CLI, a tua sessão e a skill do agente.

02 / Põe-no a trabalhar

Deixa a contabilidade para os agentes.

Registar

Dizes e fica registado.

“Adiciona o jantar de hoje de 60 € à nossa viagem a Lisboa. Paguei eu. Divide por igual comigo, Alex e Sam.”

  • Registar uma despesa
  • Registar uma despesa recorrente
  • Registar um pagamento
Ver o comando da CLI
banana expenses add --title Dinner --amount 60 \
  --currency EUR --paid-by me --date 2026-09-16 \
  --group "Lisbon trip" --split-type equal \
  --split me=20 --split Alex=20 --split Sam=20
Explorar

É só perguntares para onde foi.

“Mostra-me as minhas dez maiores despesas. Vamos ver o que pesa mais.”

  • Ver a atividade
  • Ver os saldos
  • Ver as últimas dez despesas de um grupo
Ver o comando da CLI
banana expenses list --sort amount --direction desc --limit 10 --json
Rever

Olha para trás. Olha para a frente.

“Encontra as minhas despesas recorrentes e ajuda-me a rever o que aí vem.”

  • Subscrições a chegar
  • Atividade recente
  • Editar ou apagar o que for preciso
Ver o comando da CLI
banana expenses list --recurring --sort date --direction asc --json

As moedas, os grupos e as pessoas podem ser indicados por código, nome ou um prefixo de qualquer um deles sempre que um comando o peça. Os ids continuam a funcionar, os nomes ambíguos são assinalados em vez de adivinhados, e «me» és tu. Vê o que tens com banana groups, banana friends, banana currencies, e banana me.

Está tudo à distância do agente que escolheres.

03 / Lê isto primeiro

O que os agentes precisam de saber

A CLI do BananaSplit é a camada de despesas partilhadas para agentes. Uma skill, um início de sessão, e o teu agente regista despesas, gere grupos, consulta saldos e anota pagamentos no terminal. As pessoas leem o texto. Os agentes leem JSON com --json.

O que é a CLI do BananaSplit?

A CLI do BananaSplit, chamada com banana, regista despesas partilhadas no terminal. Usa a mesma conta do BananaSplit que as apps de iOS, Android e web, por isso grupos, saldos, despesas e pagamentos ficam sincronizados.

Como ligo um agente ao BananaSplit?

Executa npx skills add teotti/banana-cli --skill banana --global, abre uma sessão nova do agente e inicia sessão com banana login. Confirmas um código no navegador. Numa máquina sem interface gráfica, abre o URL apresentado noutro dispositivo. Se a CLI já estiver instalada, banana skill install cobre o Claude Code, Codex, Cursor, Gemini CLI e opencode.

Que agentes funcionam com o BananaSplit?

Claude, Codex, Cursor, Gemini, Grok, Hermes e OpenClaw. Qualquer agente com acesso ao terminal pode correr a CLI depois de instalada e com sessão iniciada.

Como deve um agente ler o resultado?

Usa --json para JSON operacional curado, ou --raw para a resposta completa da API. Sem estas flags, o resultado é o texto legível do terminal.

Preciso de Node.js para usar a CLI do BananaSplit?

O instalador da skill precisa de Node.js. A CLI em si é um binário autónomo para macOS, Linux e Windows, verificado com as somas SHA-256 publicadas antes de substituir o que quer que seja. Também podes instalar @bananasplitapp/cli globalmente com Bun, npm ou pnpm, mas precisas de Bun 1.4+ para o executar.

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.

Explorar a CLI Consultar os comandos