firma : un CLI de gestion d’actifs local-first qui transforme Claude en assistant IA pour mon portefeuille

Il est fréquent de gérer son portefeuille d’investissement en actions étrangères avec Google Sheets.
firma est un outil CLI de gestion d’actifs local-first qui résout cet inconfort.

Fonctionnalités clés

• firma show portfolio : consulter en un coup d’œil le P&L des positions détenues, le prix de revient moyen et le prix du marché (synchronisation automatique des prix via Finnhub)
• firma add txn : enregistrer des achats/ventes/dividendes/impôts
• firma report : évolution mensuelle de la valeur nette, graphiques de flux de trésorerie
• firma show earnings/financials/news <ticker> : consulter résultats, données financières et actualités via Finnhub
• prise en charge de --json pour toutes les commandes de lecture, afin qu’une IA puisse les utiliser de manière scriptable

Intégration MCP

Une seule exécution de firma mcp install suffit pour l’enregistrer comme serveur MCP dans Claude Desktop. Ensuite, ce type de conversation devient possible :

"TSLA a beaucoup chuté aujourd’hui, quelle part représente-t-il dans mon portefeuille ?"
→ Claude interroge directement la base de données et répond immédiatement avec la quantité détenue, la pondération actuelle et le gain/la perte par rapport au prix de revient moyen

"Pourquoi mes dépenses sont-elles si élevées ce mois-ci ?"
→ analyse les données mensuelles de flux de trésorerie et les compare au mois précédent

Claude ne se contente pas de dialoguer : il gère aussi directement l’enregistrement des transactions et la saisie des soldes.

Local-first

Toutes les données sont stockées uniquement dans ~/.firma/firma.db (SQLite). Rien n’est envoyé vers un serveur externe. Les cours sont récupérés directement avec votre propre clé API Finnhub.

Installation

$ npm install -g firma-app  
$ firma config set finnhub-key YOUR_KEY  
$ firma mcp install  # redémarrez Claude Desktop et c’est terminé  

[bboydart91]

Je l’ai publié à l’aube avant d’aller dormir, et à mon réveil, une première contribution était déjà arrivée. Merci.

Après le lancement, on voyait bien les chiffres du portefeuille, mais il était difficile de comprendre comment ils se reliaient au marché actuel.
Il manquait des informations comme : est-ce qu’une forte pondération en valeurs technologiques est pertinente dans un cycle de hausse des taux, ou dans quelle mesure la force du dollar pèse réellement sur le rendement.

J’ai donc rapidement ajouté des fonctions macro ainsi qu’une fonction pour évaluer la concentration du portefeuille (le risque).

• firma show macro — snapshot macro basé sur FRED. 8 indicateurs, dont le taux directeur, les rendements des obligations d’État, le CPI et le taux de chômage.
• firma show concentration — analyse de la concentration du portefeuille avec le HHI. Par titre / devise / secteur / pays.
• firma brief — briefing quotidien basé sur les positions détenues. Movers, actualités, calendrier des résultats.
• Prise en compte du FX en temps réel sur l’ensemble du portefeuille.

Via Claude Desktop, vous pouvez directement demander quelque chose comme : « Dans l’environnement de taux actuel, qu’est-ce que vaut mon portefeuille ? »