Entrar no app

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.

Ver no GitHub Começar

Para pessoas e agentes com acesso ao terminal.
Usa o Claude ou o ChatGPT sem terminal? Conecte via MCP →
Leia a documentação completa →

Adicione 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 você.

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

Accomplishing for 5s · done

Despesas compartilhadasGrupos e amigosSaldos e pagamentosResultados em JSON

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

Obter a versão mais recente

01 Instale a skill

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

Precisa de Node.js. Escolha seu agente e abra uma sessão nova. A skill instala a CLI do Banana para você e guia você no login.

Já tem a CLI? Execute banana skill install e pronto — cobre o Claude Code, Codex, Cursor, Gemini CLI e opencode.

02 Peça ao seu agente

Use o BananaSplit para ver meus saldos.

É só isso. O login no navegador é com você, e a skill ensina seu agente a usar nomes, ler JSON, dividir despesas e registrar pagamentos.

03 Instale a CLI você mesmo

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

Binário independente. Não precisa de Node nem de Bun. Os downloads são verificados com as somas SHA-256 publicadas antes de substituir qualquer coisa. Os instaladores obtêm a versão estável mais recente para seu sistema.

04 Entre na sua conta

banana login

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

Seu agente precisa de acesso ao terminal onde a CLI está instalada e com sessão iniciada. Execute banana upgrade para manter tudo atualizado. Algo não está certo? banana doctor verifica a CLI, sua sessão e a skill do agente.

02 / Coloque para trabalhar

Deixe a contabilidade para os agentes.

Registrar

Você fala e já fica registrado.

“Adicione o jantar de hoje de €60 à nossa viagem a Lisboa. Eu paguei. Divida igualmente comigo, Alex e Sam.”

  • Registrar uma despesa
  • Registrar uma despesa recorrente
  • Registrar 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ó perguntar para onde foi.

“Mostre 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
Revisar

Olhe para trás. Olhe para a frente.

“Encontre minhas despesas recorrentes e me ajude a revisar o que vem por aí.”

  • Assinaturas a caminho
  • Atividade recente
  • Editar ou excluir 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 pedir. Os ids continuam funcionando, os nomes ambíguos são avisados em vez de adivinhados, e “me” é você. Veja o que você tem com banana groups, banana friends, banana currencies, e banana me.

Está tudo à distância do agente que você escolher.

03 / Leia isto primeiro

O que os agentes precisam saber

A CLI do BananaSplit é a camada de despesas compartilhadas para agentes. Uma skill, um login, e seu agente registra despesas, gerencia 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, registra despesas compartilhadas no terminal. Ela usa a mesma conta do BananaSplit dos apps de iOS, Android e web, então grupos, saldos, despesas e pagamentos ficam sincronizados.

Como conecto um agente ao BananaSplit?

Execute npx skills add teotti/banana-cli --skill banana --global, abra uma sessão nova do agente e entre com banana login. Você confirma um código no navegador. Em uma máquina sem interface gráfica, abra a URL exibida em outro dispositivo. Se a CLI já estiver instalada, banana skill install cobre o Claude Code, Codex, Cursor, Gemini CLI e opencode.

Quais agentes funcionam com o BananaSplit?

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

Como um agente deve ler a saída?

Use --json para JSON operacional curado, ou --raw para a resposta completa da API. Sem essas flags, a saída é 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 independente para macOS, Linux e Windows, verificado com as somas SHA-256 publicadas antes de substituir qualquer coisa. Você também pode instalar @bananasplitapp/cli globalmente com Bun, npm ou pnpm, mas precisa de Bun 1.4+ para executá-lo.

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.

Explorar a CLI Consultar os comandos