Skip to content

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

Canonical setup order: install -> login -> status -> skill install -> restart your AI assistant.

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

TUI Mode: Run bullpen with no arguments to launch the interactive terminal UI. See the TUI Guide for layout, key bindings, slash commands, and exit shortcuts.

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

Polymarket Wallet Kinds

Your Polymarket account is one of two kinds:

  • Safe / Proxy — older accounts (Gnosis Safe-based wallet). The CLI signs through Turnkey and submits via Polymarket's relayer.
  • Deposit Wallet — newer accounts (the default for new sign-ups). A deterministic CREATE2 wallet derived from your owner EOA. The CLI signs an ERC-1271 wrapped signature and submits via Polymarket's WALLET-batch relayer.

Run bullpen status to see which kind your account uses (Wallet kind: line under Trading Access). All commands — buy, sell, approve, wrap, unwrap, split, merge, redeem, revoke — work with both kinds and pick the right signing path automatically. You don't need to think about it day-to-day.

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
pUSD           432.1100         432.11

If you see USDC.e instead of pUSD, you are on a pre-migration wallet. Run bullpen polymarket wrap <amount> to convert.

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 through Bullpen 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.

Upgrade experience: Credential encryption uses a stable build-time key, so normal upgrades preserve your session. Very old installs may need a one-time bullpen logout --force && bullpen login; all subsequent upgrades are seamless.

What's New

For the most recent release notes, see the CHANGELOG. Run bullpen --version to see your installed version, and bullpen upgrade to update.

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

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.enc
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
  • TUI Guide — use the full-screen terminal UI, key bindings, slash commands, and escape routes
  • Migrate Safe to Deposit Wallet — if bullpen status shows Wallet kind: Safe/proxy and you're hitting trade errors, follow this guide
  • 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 <polymarket_addr>                         # track a Polymarket 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 deposit                                     # deposit funds (opens web app)
bullpen polymarket bridge --supported               # supported bridge assets
bullpen polymarket comments <slug>                  # view market comments
bullpen polymarket feed trades --min-pnl 10000      # filtered trade feed