8000
Skip to content

vincelwt/gloomberb

Repository files navigation

📉 Gloomberb

Extensible financial terminal, for the terminal.

Why pay for Bloomberg when you can have Gloomberb?

Gloomberb terminal screenshot

✨ Features

  • Track portfolios & trade
  • Real-time quotes & fundamentals
  • Beautiful high-rez charts
  • Fast & keyboard-driven
  • Powerful layouts
  • Extensible
  • 100% local

For the best experience, use a Kitty-compatible terminal such as Ghostty, Kitty or WezTerm.

🚀 Install

curl -fsSL gloomberb.com/install | bash
# or
bun install -g gloomberb

Then run gloomberb.

🧩 Plugins

Everything, from the portfolio list to broker integrations, is a plugin.

Plugins can add tabs, columns, command bar commands, CLI commands, status bar widgets, and more.

See PLUGINS.md for the plugin API and the shared UI surface available through gloomberb/components.

Core plugins

Plugin Description
Portfolio List Main ticker list with portfolios & watchlists
Ticker Detail Overview, financials, and chart tabs
News View latest news for each ticker (via Yahoo Finance)
SEC View recent SEC filings for supported US equities
Notes Write and save markdown notes, stored locally
Options View US equity options chains
AI Keep an Ask AI detail tab for tickers and create prompt-driven AI screener panes
Compare Charts Compare multiple ticker charts overlaid on one shared chart
X Scanner WIP
Alerts WIP
Scanner WIP

Data providers

Provider Description
Gloomberb Cloud Real-time data (recommended, free)
Yahoo Finance Delayed data, rate-limiting

Brokers connectors

Plugin Description
IBKR Import positions from Flex Query or trade with Gateway API.
Manual Entry Manually add positions, saved locally

Toggleable plugins can be enabled/disabled from the command bar screen (Ctrl+p).

💻 CLI

Running gloomberb with no arguments launches the terminal UI. Use gloomberb help to see the full command list. Feature-owned root commands such as portfolio, watchlist, and predictions are registered by their plugins rather than hardcoded in the main CLI switch.

gloomberb
gloomberb help
gloomberb search NVDA
gloomberb ticker AAPL
gloomberb portfolio create Research
gloomberb portfolio position set Research NVDA 10 400
gloomberb watchlist list
gloomberb plugins
gloomberb predictions world

⌨️ Keyboard Shortcuts

Key Action
Ctrl+P or ` Open command bar
Ctrl+x Close current window
Tab Switch between panels
j / k Navigate ticker list
h / l Switch tabs
Ctrl+, Open settings
m Cycle chart mode in the chart tab
q Quit

License

MIT

Credits

About

Finance terminal, in your terminal.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

0