Skip to content

Bullpen CLI

v0.1.114 Alpha release

Alpha

Bullpen CLI is in Alpha. Commands, APIs, and behavior may change between releases. Report bugs at github.com/BullpenFi/bullpen-cli-releases/issues. For private security reports, see Responsible Disclosure.

Trade Prediction markets on Polymarket, Perps and adjacent Hyperliquid workflows, and experimental Onchain Solana flows from your terminal or through AI agents.

Recommended setup order: install, log in, check status, install skills, then restart your AI assistant.

Start Here

  • Install and run your first command

    Get Bullpen installed, log in, verify the active account, and install AI skills.

    Quickstart

  • Trade Prediction safely

    Discover a Polymarket market, preview a buy, submit only after review, then inspect orders and positions.

    Trading

  • Make a first Onchain Solana trade

    Fund your Bullpen-managed Solana wallet, search by mint, preview a Jupiter route, submit explicitly, and reconcile balances afterward.

    Onchain Solana First Trade

  • Trade selected-DEX HIP-3 markets

    Find a HIP-3 DEX, preview a xyz:SPCX style order, submit, verify, and close the position.

    HIP-3 Perps Trading Tutorial

  • Use Pear v1 pair trading

    Set up Pear, preview a long/short basket, open a pair, update risk or leverage, and clean up exposure.

    Pear Pair Trading Tutorial

  • Preview experimental Perps copy trading

    Preview a leader subscription, configure risk, approve pending executions, pause, resume, and stop.

    Perps Copy Trading Tutorial

  • Copy Prediction traders

    Preview a prediction-market trader subscription, choose manual confirmations, and set risk limits.

    Prediction Copy Trading

  • Use Bullpen with an AI agent

    Install Bullpen skills for Claude Code, Codex CLI, Gemini CLI, OpenClaw, or .agents.

    AI Agents

Install

Bullpen CLI holds keys and signs trades. The native installer is the preferred first install. It downloads the latest official release binary from the canonical source (https://cli.bullpen.fi/install.sh, with releases published at github.com/BullpenFi/bullpen-cli-releases/releases). To inspect the script before running it, verify checksums, or understand the Homebrew trust prompt, see Verifying Your Install.

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

Use this for the simplest first install. It downloads the latest Bullpen release binary directly and avoids Homebrew tap-trust prompts. To read the installer before running it, see Verifying Your Install.

brew install BullpenFi/tap/bullpen

If Homebrew prompts you to trust the Bullpen tap, that prompt is Homebrew confirming you intend to install from the BullpenFi tap — confirm it to proceed. If it refuses to load the formula from an untrusted tap:

brew trust --formula bullpenfi/tap/bullpen
brew install BullpenFi/tap/bullpen
brew link --overwrite bullpen

To trust the full Bullpen tap instead of just the formula, run brew trust --tap bullpenfi/tap. See Verifying Your Install for why this prompt is a safety signal.

npm install -g @bullpenfi/cli

Download the latest binary from Releases. Use this path if you want to verify checksums yourself or pin a specific version. Compare the SHA-256 of the downloaded binary against the checksum published on the release page before running it — see Verifying Your Install.

Bullpen runs on Windows through Ubuntu on WSL2. On Windows 11 and recent Windows 10 builds, install WSL2 in PowerShell:

wsl --install -d Ubuntu

Older Windows 10 builds may need the manual WSL2 enablement steps or a wsl --update first; see Microsoft's WSL install guide if wsl --install is not recognized. Then open Ubuntu from the Start menu and run every Bullpen command inside the Ubuntu shell (not PowerShell):

sudo apt update
sudo apt install -y curl ca-certificates
curl -fsSL https://cli.bullpen.fi/install.sh | sh
bullpen login
bullpen status
bullpen skill install

After bullpen skill install, restart your AI assistant (Claude Code, Codex CLI, etc.) so it picks up the skills. Device-login URLs open in your Windows browser; if auto-open fails, run bullpen login --no-browser and paste the displayed URL into a Windows browser. If logins fail with auth or time errors, WSL clock skew is the usual cause — run sudo hwclock -s inside Ubuntu, or wsl --shutdown from PowerShell to restart WSL and resync the clock.

Get Started in 30 Seconds

# 1. Log in
bullpen login

# 2. Check login and trading readiness
bullpen status

# 3. If the account needs action, show one safe next step
bullpen fix --refresh

# 4. Check balances across Prediction, Perps, and Onchain Solana
bullpen portfolio balances

# 5. Discover Prediction markets
bullpen polymarket discover --limit 5

# 6. Search, then preview a guarded buy. Preview does not move money.
bullpen polymarket search "world cup" --type market --limit 5
bullpen trade buy will-ronaldo-cry-at-the-world-cup-20260604013616610 "No" 10 --max-price 0.01 --preview

# When the preview is correct, remove --preview and add --yes.
# bullpen trade buy will-ronaldo-cry-at-the-world-cup-20260604013616610 "No" 10 --max-price 0.01 --yes

Choose A Workflow

Goal Guide Exact command docs
Install, log in, and understand local auth Quickstart, Authentication login, doctor auth
Check whether the account is ready Quickstart, Troubleshooting status, fix
Trade Prediction markets Trading, Prediction (Polymarket) trade buy, trade sell, polymarket
Recover stuck funds or resolved positions Wallet Routing And Funds Recovery, Troubleshooting recover, support
Make a first Perps trade Perps First Trade hl long, hl close
Make a first Onchain Solana trade Onchain Solana First Trade solana buy, solana balance
Trade selected-DEX HIP-3 markets HIP-3 Perps Trading Tutorial hl perp-dexes, hl long, hl orders
Trade through Pear Pear Pair Trading Tutorial hl pair
Copy Prediction traders Prediction Copy Trading tracker copy
Copy Perps leaders Perps Copy Trading Tutorial hl copy
Use agents or headless servers AI Agents, Headless & Docker Setup skill, JSON Output Contract
Inspect output, errors, and schemas Output And Errors Command Reference

Safety Model

Bullpen is designed for preview-first workflows:

  • Read commands can usually run with --output json for scripts and agents.
  • Live trading commands require explicit feature gates, --yes, or both.
  • --preview and --dry-run show intent without signing or submitting.
  • --read-only blocks live mutation even when a command supports --yes.
  • Experimental surfaces are documented as experimental on their task guides and generated command pages.

Key Areas

Prediction (Polymarket)

Discover markets, preview buys and sells, place limit orders, inspect positions, manage open orders, wrap collateral, and redeem eligible positions. Start with Trading.

Perps (Hyperliquid)

Read account state, trade perps and spot, manage orders, set TP/SL, inspect agent slots, use Pear pair trades, trade HIP-3 markets, and manage Perps copy trading. Start with Perps (Hyperliquid).

Onchain (Solana)

Use experimental balance, token-search, swap, limit-order, DCA, withdraw, and deposit-guidance flows. Start with Onchain Solana First Trade, then use Onchain (Solana) for the full command surface.

Agents

Install Bullpen skills so Claude Code, Codex CLI, Gemini CLI, OpenClaw, or .agents can use the same command surface. Start with AI Agents.

Reference