firma: uma CLI local-first de gestão de ativos que transforma o Claude no meu assistente de IA para portfólio

Ao investir em ações no exterior, é comum fazer a gestão do portfólio no Google Sheets.
firma é uma ferramenta CLI local-first de gestão de ativos que resolve esse incômodo.

Principais recursos

• firma show portfolio: visualiza de uma vez só o P&L das posições, preço médio e preço de mercado (sincronização automática de preços via Finnhub)
• firma add txn: registra compra/venda/dividendo/imposto
• firma report: tendência mensal do patrimônio líquido e gráficos de fluxo de caixa
• firma show earnings/financials/news <ticker>: consulta resultados, dados financeiros e notícias com base no Finnhub
• suporte a --json em todos os comandos de leitura, permitindo uso automatizável por IA

Integração com MCP

Com um único firma mcp install, ele é registrado como servidor MCP no Claude Desktop. Depois disso, conversas como estas passam a ser possíveis:

"TSLA caiu bastante hoje, como está o peso dela no meu portfólio?"
→ O Claude consulta diretamente o banco de dados e responde na hora com quantidade em carteira, peso atual e lucro/prejuízo em relação ao preço médio

"Por que meus gastos estão tão altos neste mês?"
→ Ele analisa os dados mensais de fluxo de caixa e compara com o mês anterior

O Claude não apenas conversa: ele também processa diretamente o registro de operações e a entrada de saldo.

Local-first

Todos os dados são armazenados apenas em ~/.firma/firma.db (SQLite). Nada é enviado para servidores externos. A consulta de preços é feita diretamente com a sua própria chave de API do Finnhub.

Instalação

$ npm install -g firma-app  
$ firma config set finnhub-key YOUR_KEY  
$ firma mcp install  # basta reiniciar o Claude Desktop  

[bboydart91]

Eu postei de madrugada e fui dormir, mas quando acordei já tinha chegado a primeira contribuição. Obrigado.

Depois do lançamento, eu conseguia ver os números do portfólio, mas não dava para ver como eles se conectavam com o mercado atual.
Faltavam informações como se uma maior exposição a ações de tecnologia faz sentido em um cenário de alta de juros, ou quanto a força do dólar realmente impacta a rentabilidade.

Então adicionei rapidamente recursos de macro e uma função para avaliar a concentração (risco) do portfólio.

• firma show macro — snapshot macroeconômico com base no FRED. 8 indicadores, incluindo taxa básica de juros, rendimento dos títulos do Tesouro, CPI e desemprego.
• firma show concentration — análise de concentração do portfólio com HHI. Por ativo/moeda/setor/país.
• firma brief — briefing diário com base nos ativos em carteira. Movimentações, notícias e calendário de resultados.
• Aplicação de FX em tempo real em todo o portfólio.

Pelo Claude Desktop, dá para perguntar direto algo como "Como está meu portfólio no ambiente atual de juros?".