Skip to content

Bullpen CLI

v0.1.117 Unreleased release candidate

Unreleased release candidate

This documentation describes the v0.1.117 release candidate. The latest published release is v0.1.116. v0.1.117 is not available through normal install or upgrade channels until the release tag is published. Bullpen remains alpha in maturity: 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, check bullpen status, run bullpen doctor auth, log in only when diagnostics require it, rerun bullpen status, preview the first action, confirm only after review, then install skills and restart your AI assistant.

Start Here

  • Install and run your first command

    Get Bullpen installed, inspect status and auth diagnostics, log in only when those checks require it, rerun status, then 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. Bullpen has two canonical binary provenance sources: the native installer at https://cli.bullpen.fi/install.sh and GitHub Releases at github.com/BullpenFi/bullpen-cli-releases/releases. Homebrew and npm are supported installers, but not additional canonical provenance sources. Documentation for an unreleased candidate does not make that candidate available through the installer until its release is published. 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 published 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 published 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). Run the installer only when setting up WSL:

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

Device-login URLs open in your Windows browser. If diagnostics require login and auto-open fails, run bullpen login --no-browser, paste the displayed URL into a Windows browser, complete login, then rerun bullpen status.

Preview skill installation only after status confirms the session is ready and only when you want AI-assistant integration:

bullpen skill install --dry-run

After reviewing the preview, install the skills:

bullpen skill install

Restart your AI assistant (Claude Code, Codex CLI, etc.) after installation so it picks up the skills. If login fails 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

Not copy-pasteable as one sequence: start with passive checks, run login only when diagnostics require it, then continue.

bullpen status
bullpen doctor auth

Run bullpen login only if status or auth diagnostics direct you to log in. Not copy-pasteable as a login sequence; rerun passive status afterward:

bullpen status

Reserve bullpen doctor auth --refresh --output json or bullpen fix --refresh for stale or expired sessions, support requests, or cases where diagnostics explicitly ask for refreshed evidence.

Check balances:

bullpen portfolio balances

Discover markets and choose a slug:

bullpen polymarket discover --limit 5
bullpen polymarket search "world cup" --type market --limit 5

Preview a guarded buy with the returned slug. Preview does not move money.

bullpen trade buy <MARKET_SLUG_FROM_SEARCH> "No" 10 --max-price 0.01 --preview

Live: Run this only after the preview above matches your intent. This command can submit a real Prediction trade.

bullpen trade buy <MARKET_SLUG_FROM_SEARCH> "No" 10 --max-price 0.01 --yes

Choose A Workflow

Goal Guide Exact command docs
Install and understand local auth Quickstart, Authentication status, doctor auth, login
Look up public Bullpen account identity Account Identity bullpen identity show <USERNAME_OR_USER_ID> [--output table\|json]
Check local login state and active trading readiness 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.
  • Polymarket market buys require at least $1 of executable spend and may still reject when the normalized live taker fill would be below the market's current minimum order size. Sells, limit buys, and limit sells must meet the market's current minimum order size.

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