Overview

Trade Polymarket from your terminal, or let AI agents trade for you.

Bullpen CLI

Bullpen CLI gives you market discovery, order entry, portfolio tools, and smart money data from the terminal.

Bullpen CLI is in Beta. Commands may change between releases. Report bugs at github.com/BullpenFi/bullpen-cli-releases/issues.

Requirements

OS	Version
macOS	12+
Linux	Ubuntu 20.04+ / Debian 10+
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 from GitHub Releases.

Windows Install WSL2 first, then use any of the methods above inside your WSL terminal.

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

Update anytime: bullpen upgrade

Log In

bullpen setup

This handles config, login, and Polymarket approvals in one step. A code and URL appear in your terminal. Open the URL in your browser, enter the code, done.

You can also do each step separately:

bullpen config init
bullpen login

Confirm you're connected:

bullpen status

Your First Trade

bullpen polymarket discover --limit 5          # browse trending markets
bullpen polymarket search "bitcoin"            # search for a topic
bullpen polymarket price will-btc-reach-100k   # check the price
bullpen polymarket buy will-btc-reach-100k "Yes" 10 --preview   # preview (no money moves)
bullpen polymarket buy will-btc-reach-100k "Yes" 10 --yes       # execute
bullpen polymarket positions                   # check your position

Polymarket requires one-time approvals before your first trade. bullpen setup handles this, but if you skipped it:

bullpen polymarket approve --yes

Interactive Mode

Run bullpen with no arguments for a full-screen terminal UI. No commands to memorize.

You can also use the interactive shell to skip typing bullpen on every command:

bullpen shell

bullpen> polymarket discover --limit 5
bullpen> polymarket price will-btc-reach-100k
bullpen> exit

Tab completion:

bullpen completion zsh >> ~/.zshrc && source ~/.zshrc

What's in the CLI

Feature	What You Get
Markets	Discover, search, filter, and inspect prices, trades, holders, comments, and leaderboards
Trading	Buy, sell, place limit orders, and redeem resolved positions
Smart Money	Follow traders, filter trade feeds by P&L and volume, and set alerts
Portfolio	Balances and P&L across Polymarket, Solana, and Hyperliquid
Bridge	Deposit and withdraw through the Polymarket bridge
Points	Check points, view rewards, and claim payouts
Scripting	--output json support on every read command

Configuration

Config lives at ~/.bullpen/config.toml.

bullpen config init      # generate default config
bullpen config show      # view current config

Uninstall

bullpen skill uninstall --yes       # remove AI skills (if installed)
brew uninstall bullpen              # remove binary (Homebrew)
npm uninstall -g @bullpenfi/cli     # remove binary (npm)
rm "$(which bullpen)"              # remove binary (shell / manual)
rm -rf ~/.bullpen                   # remove local data, credentials, config

Bullpen CLI is in Beta. Commands may change between releases. Report bugs at github.com/BullpenFi/bullpen-cli-releases/issues.