Bullpen CLI Quickstart¶

Bullpen CLI lets you authenticate, view portfolio balances, discover prediction markets, and trade from the terminal.

System Requirements¶

Requirement	Details
Operating systems	macOS 12+, Ubuntu 20.04+/Debian 10+, or Windows 11 via WSL2

Install¶

Homebrew (macOS / Linux)¶

brew install BullpenFi/tap/bullpen

npm¶

npm install -g @bullpenfi/cli

Shell Script¶

curl -fsSL https://cli.bullpen.fi/install.sh | sh

Manual Download¶

Download the latest binary from Releases.

If bullpen is not found after install, ensure the install location is on your PATH.

Getting Started¶

Log in (device auth):
```
bullpen login
```
A code and URL are displayed. Open the URL in your browser.
Enter the code and complete login in the browser.
The CLI automatically picks up your session — no copy-pasting required.
Check your balances:
```
bullpen portfolio balances
```

TUI Mode: Run bullpen with no arguments to launch the interactive terminal UI for a full-screen experience.

AI Agent Mode: Install skills with bullpen skill install, restart Claude Code or Codex CLI, then trade through natural language.

Expected output (example):

Total USD (All): 1234.56

[Solana] Address: ...  Chain: Solana (0)
Total USD: 345.67
Symbol          Balance        Value USD
SOL            1.2345            123.45
USDC          10.0000            10.00

[Hyperliquid Spot] Address: ...  Chain: HyperCore Spot (6)
Total USD: 456.78
Symbol          Balance        Value USD
USDC          100.0000          100.00

[Polymarket] Address: ...  Chain: Polygon (10)
Total USD: 432.11
Symbol          Balance        Value USD
USDC.e         432.1100         432.11

AI Agent Skills¶

Install skills so Claude Code or Codex CLI can trade on your behalf:

bullpen skill install
# Restart Claude Code / Codex CLI after installing

What Balances Are Included¶

The CLI fetches balances via usergate for: - Solana - Hyperliquid (HyperCore Spot + Perps) - Polymarket (via Polygon proxy)

Configuration¶

Config lives at ~/.bullpen/config.toml (or $BULLPEN_HOME/config.toml). To generate a default config:

bullpen config init

To force a different environment:

bullpen --env staging portfolio balances

Update notifications: The CLI automatically checks for updates in the background and prints a notice to stderr when a newer version is available. This check is non-blocking and does not slow down commands. To disable, add check_for_updates = false to your config.toml.

Logging¶

Set RUST_LOG to enable log output:

RUST_LOG=info bullpen status

Uninstall¶

Step 1: Remove AI skills (optional)¶

If you installed AI skills, remove them first:

bullpen skill uninstall --yes

Step 2: Remove the binary¶

HomebrewnpmShell Script / Manual

brew uninstall bullpen
brew untap bullpenfi/tap  # optional: remove the tap

npm uninstall -g @bullpenfi/cli

rm "$(which bullpen)"
# Also remove from PATH in ~/.zshrc or ~/.bashrc if added by the installer:
# Delete the line: export PATH="$HOME/.bullpen/bin:$PATH"

Step 3: Clean up local data (optional)¶

Remove configuration, credentials, and keys:

rm -rf ~/.bullpen

Warning

This deletes your stored credentials, Turnkey keys, and config. You'll need to log in again if you reinstall.

If you want to keep your config but clear credentials:

rm ~/.bullpen/credentials.json
rm -rf ~/.bullpen/keys

Next Steps¶

Prediction Markets — discover, search, and analyze markets (event details, price history, trades, holders, leaderboard, smart money, social & community)
Trading — buy, sell, redeem shares, and place limit orders
Orders and Watchlist — manage orders and watchlist
Command Reference — complete per-command reference for all commands
LLM Bundle — single-file concatenation of public docs for LLM ingestion

Other useful commands:

bullpen status                                                 # CLI + account status
bullpen portfolio pnl                                          # view profit & loss
bullpen points                                                 # view your points
bullpen rewards                                                # view and claim rewards
bullpen notifications                                          # view notifications
bullpen tracker add <addr> --chain solana                      # track a wallet
bullpen polymarket price <slug>                     # real-time bid/ask/mid
bullpen polymarket market <slug>                    # detailed market info
bullpen polymarket markets --active --sort volume   # browse markets
bullpen polymarket deposit --address 0xYourWallet   # get bridge deposit addresses
bullpen polymarket bridge --supported               # supported bridge assets
bullpen polymarket comments <slug>                  # view market comments
bullpen polymarket feed trades --min-pnl 10000      # filtered trade feed