firma: un CLI local-first de gestión de activos que convierte a Claude en mi asistente de IA para el portafolio

Al invertir en acciones extranjeras, mucha gente suele gestionar su portafolio con Google Sheets.
firma es una herramienta CLI de gestión de activos local-first que resuelve esa incomodidad.

Funciones principales

• firma show portfolio: consulta de un vistazo el P&L de las posiciones, el costo promedio y el precio de mercado (sincronización automática de precios con Finnhub)
• firma add txn: registra compras/ventas/dividendos/impuestos
• firma report: tendencia mensual del patrimonio neto y gráficos de flujo de caja
• firma show earnings/financials/news <ticker>: consulta de resultados financieros/finanzas/noticias basada en Finnhub
• todos los comandos de lectura admiten --json, por lo que la IA puede usarlos de forma scriptable

Integración con MCP

Con una sola ejecución de firma mcp install, queda registrado como servidor MCP en Claude Desktop. Después se pueden tener conversaciones como estas:

"TSLA cayó mucho hoy, ¿qué peso tiene ahora en mi portafolio?"
→ Claude consulta directamente la DB y responde al instante con la cantidad en cartera, el peso actual y la ganancia o pérdida frente al costo promedio

"¿Por qué mis gastos estuvieron tan altos este mes?"
→ Analiza los datos mensuales de flujo de caja y los compara con el mes anterior

Claude no solo conversa: también procesa directamente los registros de compra/venta y la carga de saldos.

Local-first

Todos los datos se guardan únicamente en ~/.firma/firma.db (SQLite). No se envía nada a servidores externos. La consulta de precios se hace directamente con tu propia API key de Finnhub.

Instalación

$ npm install -g firma-app  
$ firma config set finnhub-key YOUR_KEY  
$ firma mcp install  # reinicia Claude Desktop y listo  

[bboydart91]

Lo publiqué de madrugada y me fui a dormir, pero al despertar ya había llegado la primera contribución. Gracias.

Después del lanzamiento podía ver los números del portafolio, pero no podía ver cómo se conectaban con el mercado actual.
Faltaba información como si está bien tener una alta proporción de acciones tecnológicas en un entorno de tasas en alza, o cuánto impacta realmente un dólar fuerte en la rentabilidad.

Así que agregué rápidamente funciones macro y una función para evaluar la concentración (riesgo) del portafolio.

• firma show macro — snapshot macro basado en FRED. 8 indicadores, incluyendo tasa de referencia, rendimiento de bonos del Tesoro, CPI y tasa de desempleo.
• firma show concentration — análisis de concentración del portafolio con HHI. Por activo, moneda, sector y país.
• firma brief — briefing diario basado en las posiciones en cartera. Movers, noticias y calendario de resultados.
• Aplicación de FX en tiempo real en todo el portafolio.

A través de Claude Desktop puedes preguntar directamente cosas como: "¿Cómo está mi portafolio en el entorno actual de tasas?"