bullpen¶
Last updated: May 29, 2026
Bullpen CLI (Alpha) — trade prediction markets from your terminal
Usage¶
Subcommands¶
| Subcommand | Description |
|---|---|
login |
Log in to Bullpen via device auth (RFC 8628): displays a code, opens browser |
logout |
Log out and clear stored credentials |
config |
Initialize and manage CLI configuration |
portfolio |
View portfolio balances, overview, and P&L across all chains |
polymarket |
Polymarket prediction market commands: discover, search, trade, and manage positions [aliases: pm, prediction] |
points |
Show Bullpen points balance and distribution history |
rewards |
Show and claim available rewards |
quests |
Show current Bullpen quests and quest history |
notifications |
View and manage account notifications |
tracker |
Track wallets and monitor smart money activity |
wallet |
Manage wallets — list accounts, select primary wallet per chain |
funds |
Multi-chain balance view across Polymarket, Hyperliquid, and Solana. (For deposits and cross-chain transfers, use https://app.bullpen.fi.) |
completion |
Generate shell completion scripts for bash, zsh, fish, elvish, or PowerShell |
shell |
Launch an interactive REPL shell with readline history |
setup |
Guided first-time setup: configure, authenticate, and approve Polymarket trading |
status |
Show CLI version, environment, account info, and Polymarket platform status |
version |
Print the Bullpen CLI version |
experimental |
Enable, disable, and list experimental features |
skill |
Manage AI agent skill files (install, update, list, uninstall) |
hyperliquid |
Hyperliquid perp trading, account reads, and order workflows (experimental) |
deposit |
Deposit funds into your Bullpen account (opens web app) |
verify-email |
Verify your email for full account access |
upgrade |
Update the bullpen binary to the latest release from GitHub |
doctor |
Diagnose auth and account health |
solana |
Solana token balances and DeFi operations (experimental) |
Live Help¶
Bullpen CLI (Alpha) — trade prediction markets from your terminal
Usage: bullpen [OPTIONS] [COMMAND]
Commands:
login Log in to Bullpen via device auth (RFC 8628): displays a code, opens browser
logout Log out and clear stored credentials
config Initialize and manage CLI configuration
portfolio View portfolio balances, overview, and P&L across all chains
polymarket Polymarket prediction market commands: discover, search, trade, and manage positions [aliases: pm, prediction]
points Show Bullpen points balance and distribution history
rewards Show and claim available rewards
quests Show current Bullpen quests and quest history
notifications View and manage account notifications
tracker Track wallets and monitor smart money activity
wallet Manage wallets — list accounts, select primary wallet per chain
funds Multi-chain balance view across Polymarket, Hyperliquid, and Solana. (For deposits and cross-chain transfers, use https://app.bullpen.fi.)
completion Generate shell completion scripts for bash, zsh, fish, elvish, or PowerShell
shell Launch an interactive REPL shell with readline history
setup Guided first-time setup: configure, authenticate, and approve Polymarket trading
status Show CLI version, environment, account info, and Polymarket platform status
version Print the Bullpen CLI version
experimental Enable, disable, and list experimental features
skill Manage AI agent skill files (install, update, list, uninstall)
hyperliquid Hyperliquid perp trading, account reads, and order workflows (experimental)
deposit Deposit funds into your Bullpen account (opens web app)
verify-email Verify your email for full account access
upgrade Update the bullpen binary to the latest release from GitHub
doctor Diagnose auth and account health
solana Solana token balances and DeFi operations (experimental)
help Print this message or the help of the given subcommand(s)
Options:
--output <OUTPUT>
Output format for command results
[possible values: table, json]
--env <ENV>
Target environment to connect to (overrides config.toml)
[env: BULLPEN_ENV=]
[possible values: staging, production]
--config <CONFIG>
Path to a custom config.toml file (overrides $BULLPEN_CONFIG and the default location).
Explicit --config and BULLPEN_CONFIG paths fail closed: if the file is missing, the CLI exits validation instead of silently loading defaults. Credentials still resolve via BULLPEN_HOME, so set BULLPEN_HOME too when isolating a session.
--read-only
Enable read-only mode: blocks all mutating commands
--non-interactive
Suppress interactive prompts; does NOT imply --yes for money-moving commands
[env: BULLPEN_NON_INTERACTIVE=]
-h, --help
Print help (see a summary with '-h')
-V, --version
Print version
ENVIRONMENT VARIABLES:
BULLPEN_HOME Override the Bullpen data directory (default: ~/.bullpen)
BULLPEN_CONFIG Override the path to config.toml (default: $BULLPEN_HOME/config.toml). Fails closed if the explicit path is missing
BULLPEN_ENV Override the target environment (staging|production)
BULLPEN_READ_ONLY Set to 1/true/yes/on to block all mutating commands globally
BULLPEN_NON_INTERACTIVE Set to 1/true/yes/on to suppress interactive prompts; does NOT imply --yes for money-moving commands
BULLPEN_DISABLE_VERSION_GATE Set to 1/true/yes/on to bypass the minimum-version kill-switch (emergency use only)
BULLPEN_DISABLE_TELEMETRY Set to 1/true/yes/on to opt out of anonymous usage telemetry
BULLPEN_GITHUB_TOKEN GitHub personal access token used by `upgrade` and update checks to avoid rate limits
BULLPEN_UPDATE_URL Override the GitHub releases API URL for `upgrade` and version checks
BULLPEN_POLYGON_RPC_URL Override the Polygon JSON-RPC endpoint (default: built-in public Polygon RPC)
BULLPEN_ARBITRUM_RPC_URL Override the Arbitrum JSON-RPC endpoint for Hyperliquid deposit helpers
BULLPEN_SOLANA_RPC_URL Override the Solana JSON-RPC endpoint
BULLPEN_SOLANA_DEFAULT_SLIPPAGE_BPS Override default Solana swap slippage in basis points
BULLPEN_SOLANA_REFERRAL_ACCOUNT Optional Jupiter referral token account for Solana swaps
BULLPEN_SOLANA_REFERRAL_FEE_BPS Optional Jupiter referral fee in basis points for Solana swaps
BULLPEN_SUPPRESS_DEPRECATION_WARNINGS Suppress migration/deprecation warnings in supported commands
BULLPEN_DISABLE_ROUTING_WARNING_SUPPRESSION Always show Polymarket wallet-routing warnings
BULLPEN_HYPERLIQUID_FORCE_COMPAT_NO_BUILDER_ORDER_PLACEMENT Disable Hyperliquid builder-order placement for compatibility
RUST_LOG Enable file logging; e.g. RUST_LOG=debug writes to ~/.bullpen/log/bullpen-cli.log