# Gloomberb
**Open-source finance terminal. Fast, keyboard-driven, and extensible.**
Desktop app for macOS and Windows. Terminal UI for macOS, Linux, and Windows.
Download desktop
·
Install the TUI
## Desktop App or TUI?
Gloomberb has two ways in:
| Surface | Best for | How it runs |
|---------|----------|-------------|
| Desktop app | A polished app window, pop-out panes, OS shortcuts, and built-in updates | Published for macOS and Windows. It also installs a `gloomberb` terminal command for the TUI. |
| Terminal UI | Fast keyboard workflows inside your terminal, SSH/dev boxes, Linux machines, and script-friendly setups | Runs with `gloomberb` on macOS, Linux, and Windows. |
Both share the same command language, plugin system, market data surfaces, portfolios, watchlists, alerts, notes, and AI tools.
## Install
### macOS
Install the desktop app and the `gloomberb` terminal command:
```bash
brew install --cask vincelwt/tap/gloomberb
# or
curl -fsSL gloomberb.com/install | bash
```
Both install `Gloomberb.app` and a `gloomberb` command that runs the TUI through the app bundle, so the bundled runtime is stored once.
Prefer a direct download?
- [Download Gloomberb for Mac](https://gloomberb.com/download/desktop)
### Linux
Install the standalone TUI binary:
```bash
curl -fsSL gloomberb.com/install | bash
```
This installs `gloomberb` to `~/.local/bin` by default. A Linux desktop package is not published yet.
### Windows
Install the desktop app:
- [Download GloomberbSetup.exe for Windows x64](https://github.com/vincelwt/gloomberb/releases/latest/download/stable-win-x64-GloomberbSetup.exe)
The installer adds the app and a `gloomberb` terminal command. For a terminal-only setup, install Bun and use the package:
```powershell
bun install -g gloomberb
```
### Terminal Package
Already have Bun installed on any supported OS?
```bash
bun install -g gloomberb
```
Then run:
```bash
gloomberb
```
On macOS and Windows, desktop updates replace the installed app in place and keep the terminal command pointing at the updated runtime. Homebrew users can also update through `brew upgrade --cask gloomberb`.
For the best terminal experience, use a [Kitty](https://sw.kovidgoyal.net/kitty/)-compatible terminal such as Ghostty, Kitty, or WezTerm.
## Start
Open command mode with `Ctrl+P`, then type a command. Press `` ` `` to open ticker search directly.
| Try | Opens |
|-----|-------|
| `DES AAPL` | Security details |
| `GP NVDA` | Price chart |
| `TOP` | Ranked market stories |
| `HM` | Market heatmap |
| `MOST` | Market movers |
| `PF` | Portfolios and watchlists |
| `KELLY AAPL` | Position sizing |
| `HELP` | Full in-app shortcut list |
## What It Does
- Research companies with quotes, charts, financials, filings, holders, insiders, options, analyst ratings, events, and relative valuation.
- Follow markets with top stories, breaking news, sector feeds, Substack subscriptions, global indices, FX, macro events, yield curves, market movers, and fear/greed.
- Track portfolios and watchlists, connect brokers, set alerts, keep notes, run AI screens, browse prediction markets, and use Gloom Cloud chat.
## CLI
Running `gloomberb` with no arguments launches the terminal UI. Normal commands run through a headless CLI path; use `gloomberb launch-ui` when a script should explicitly open the UI.
Human-readable output is the default. Automation can opt into structured output with `--json`, `--csv`, or `--ndjson`. JSON output favors the richest fetched model available and includes display-column metadata when a command has table columns; CSV and NDJSON use the command's tabular row view. Common global flags include `--limit`, `--refresh`, `--quiet`, `--no-color`, `--dry-run`, and `--yes`.
| Command | Use |
|---------|-----|
| `gloomberb` | Launch the terminal UI |
| `gloomberb launch-ui` | Explicitly launch the terminal UI |
| `gloomberb help` | Show all CLI commands |
| `gloomberb api list|get|invoke|subscribe` | Inspect and call plugin capabilities directly |
| `gloomberb quote