mtzanidakis/budgeting

O que budgeting faz?

Aplicativo web progressivo (PWA) auto-hospedado para orçamento familiar em Go + SQLite. Com suporte a múltiplos usuários, modo offline, tokens de API e CLI amigável para agentes (skill para Claude Code).

Visão Geral

Budgeting é uma solução de orçamento familiar leve e auto-hospedada. Construído com Go e SQLite, oferece uma PWA que funciona offline, permitindo que famílias gerenciem suas finanças com privacidade total. O sistema suporta autenticação via tokens de API, facilitando a integração com agentes de IA como o Claude Code.

Funcionalidades

• Múltiplos usuários: Cada membro da família pode ter sua própria conta.
• Offline-first: O PWA funciona mesmo sem conexão com a internet.
• Tokens de API: Permite que agentes e scripts interajam programaticamente com o sistema.
• CLI amigável: Interface de linha de comando projetada para ser usada por agentes de IA.
• Relatórios: Geração de relatórios de gastos, receitas e saldos.

Uso com Claude Code

Para usar com Claude Code, configure o token de API e o endpoint do servidor:

export BUDGETING_API_TOKEN="seu_token_aqui"
export BUDGETING_API_URL="http://localhost:8080"

Comandos disponíveis:

• budgeting balance - Exibe o saldo atual de todas as contas.
• budgeting add-transaction <valor> <descrição> - Adiciona uma nova transação.
• budgeting list-accounts - Lista todas as contas cadastradas.
• budgeting report <mês>/<ano> - Gera um relatório financeiro para o período.

Instalação

1. Baixe o binário para sua plataforma em releases.
2. Execute ./budgeting init para criar o banco de dados SQLite.
3. Configure o servidor com ./budgeting serve --port 8080.
4. Acesse a PWA em http://localhost:8080 no navegador.

Licença

Este projeto é distribuído sob a licença MIT. Consulte o arquivo LICENSE para mais detalhes.