firma: CLI manajemen aset local-first yang menjadikan Claude asisten AI untuk portofolio saya

Saat berinvestasi saham luar negeri, banyak orang mengelola portofolionya dengan Google Spreadsheet.
firma adalah alat manajemen aset CLI local-first yang menyelesaikan ketidaknyamanan itu.

Fitur utama

• firma show portfolio: lihat P&L posisi yang dimiliki, harga rata-rata, dan harga pasar sekaligus (sinkronisasi harga otomatis via Finnhub)
• firma add txn: catat pembelian/penjualan/dividen/pajak
• firma report: tren aset bersih bulanan, grafik arus kas
• firma show earnings/financials/news <ticker>: lihat laporan laba, keuangan, dan berita berbasis Finnhub
• Semua perintah read mendukung --json, sehingga AI bisa menggunakannya secara scriptable

Integrasi MCP

Hanya dengan satu kali firma mcp install, firma akan terdaftar sebagai server MCP di Claude Desktop. Setelah itu, percakapan seperti ini menjadi mungkin:

"TSLA turun banyak hari ini, bagaimana porsi bobotnya di portofolio saya?"
→ Claude langsung mengakses DB dan menjawab jumlah kepemilikan, bobot saat ini, serta untung-rugi dibanding harga rata-rata

"Kenapa pengeluaran bulan ini tinggi sekali?"
→ Menganalisis data arus kas bulanan lalu membandingkannya dengan bulan sebelumnya

Claude bukan hanya sekadar bercakap-cakap, tetapi juga langsung menangani pencatatan transaksi dan input saldo.

Local-first

Semua data hanya disimpan di ~/.firma/firma.db (SQLite). Tidak ada yang dikirim ke server eksternal. Pengambilan harga dilakukan langsung memakai API key Finnhub milik pengguna sendiri.

Instalasi

$ npm install -g firma-app  
$ firma config set finnhub-key YOUR_KEY  
$ firma mcp install  # setelah restart Claude Desktop, selesai  

[bboydart91]

Saya mengunggahnya dini hari lalu langsung tidur, dan ketika bangun ternyata kontribusi pertama sudah masuk. Terima kasih.

Setelah diluncurkan, angka-angka portofolio memang terlihat, tetapi saya belum bisa melihat bagaimana semuanya terhubung dengan kondisi pasar saat ini.
Informasi seperti apakah porsi saham teknologi masih masuk akal di fase kenaikan suku bunga, atau seberapa besar penguatan dolar benar-benar memengaruhi imbal hasil, masih belum ada.

Karena itu, saya cepat-cepat menambahkan fitur makro dan fitur untuk menilai tingkat konsentrasi (risiko) portofolio.

• firma show macro — snapshot makro berbasis FRED. 8 indikator termasuk suku bunga acuan, imbal hasil obligasi pemerintah, CPI, dan tingkat pengangguran.
• firma show concentration — analisis konsentrasi portofolio dengan HHI. Berdasarkan saham/mata uang/sektor/negara.
• firma brief — briefing harian berdasarkan aset yang dimiliki. Pergerak utama, berita, jadwal laporan kinerja.
• Penerapan FX real-time di seluruh portofolio.

Melalui Claude Desktop, Anda bisa langsung menanyakan hal seperti, "Bagaimana kondisi portofolio saya di lingkungan suku bunga saat ini?"