Config

All firma settings live locally in ~/.firma/config.json. Use `firma config set` and `firma config get` to manage them. No restart is required.

firma config get

Shows all current config values. Pass a key name to read just one.
$firma config get
$firma config get currency

firma config set <key> <value>

firma config set finnhub-key <key>Set your Finnhub API key
firma config set fred-key <key>Set your FRED API key
firma config set currency KRWSet the display currency (USD, KRW, JPY, EUR, GBP, CNY)
firma config set db-path ~/path/to/firma.dbMove the database file, useful for iCloud or Dropbox sync

Keys

F-KEY
finnhub-key
Finnhub API key. Required for firma sync, firma show portfolio, firma show news, firma show insider, firma show financials, and firma show earnings. Free tier at finnhub.io covers all firma features.
FRED
fred-key
FRED API key. Required for firma show macro, firma show stress, firma show regime, and firma sync fx. You can register for free at fred.stlouisfed.org.
FX
currency
Your home currency for display. Defaults to USD. Supported: USD, KRW, JPY, EUR, GBP, CNY. Affects portfolio value, balance, flow, report, and the FX row in firma show macro.
DB
db-path
Absolute path to the SQLite database. Defaults to ~/.firma/firma.db. Point it at a file on iCloud Drive or Dropbox if you want the same data on multiple machines. Just make sure only one machine is writing at a time.

Related

firma doctorVerify all keys are set and data is present
firma sync fxPopulate the FX cache after setting your FRED key
firma mcp installRegister firma as an MCP server in Claude Desktop
Config is stored as plain JSON at ~/.firma/config.json. On macOS, it is readable only by your user account.
MIT License