Introduction: Live Demo Walkthrough¶
A step-by-step guide for demoing the Bullpen CLI on a fresh macOS machine. Every command is pre-filled and ready to copy-paste. Example output is shown below each command.
Recommended setup order: install, log in, check status, run fix if needed, install skills, then restart your AI assistant.
1. Install¶
Prefer the native installer for fresh demo machines — it downloads the latest
official release binary from the canonical source
(https://cli.bullpen.fi/install.sh). If you use Homebrew and it refuses the
Bullpen tap as untrusted, that prompt is Homebrew confirming you intend to
install from the BullpenFi tap; run brew trust --formula bullpenfi/tap/bullpen
before retrying brew install BullpenFi/tap/bullpen. To inspect the installer
before running it or compare published SHA-256 checksums, see
Verifying Your Install.
This walkthrough is written for a fresh macOS machine. On Windows, follow the WSL2 path in the Quickstart or Overview first, then continue from step 2 below inside your Ubuntu terminal.
Verify:
2. First-Time Setup¶
Run the guided wizard — it initializes config, opens login, and checks Polymarket approvals in one flow:
Or do it manually:
A code and URL are displayed. Open the URL in your browser, enter the code, and login completes automatically.
Check login and trading readiness:
Bullpen CLI v0.1.114 (Alpha)
Environment: production
Update: up to date
Account
Status: Logged in
Session: Ready
Readiness
Trading: Ready
Next step: Run `bullpen polymarket discover --limit 10`.
If status says action is needed, run:
3. Install AI Agent Skills (Optional)¶
Install skills so Claude Code or Codex CLI can trade on your behalf through natural language:
Installed 38 skill files to 1 location(s):
[Claude Code (personal)] /Users/you/.claude/skills/bullpen-cli
After installing, restart Claude Code or Codex CLI. Then just ask:
- "Find an active prediction market, preview a guarded buy, then wait for my confirmation."
- "Show me trending crypto prediction markets"
- "What are my open positions?"
4. Check Your Account¶
Bullpen CLI v0.1.114 (Alpha)
Environment: production
Update: up to date
Account
Status: Logged in
Session: Ready
Readiness
Trading: Ready
Next step: Run `bullpen polymarket discover --limit 10`.
Polymarket
Status: UP
╭──────────────────────────────────╮
│ Total Portfolio Value +$337.30 │
│ $372.72 │
├──────────────────────────────────┤
│ Solana -$15.66 │
│ $19.75 │
├──────────────────────────────────┤
│ Hyperliquid $0.00 │
│ $0.00 │
├──────────────────────────────────┤
│ Polymarket +$352.96 │
│ $352.96 │
╰──────────────────────────────────╯
5. Discover Markets¶
Browse trending markets:
Market Odds Vol 24h Liquidity Ends
-----------------------------------------------------------------------------------------------------
Example high-liquidity market Yes 14¢ / No 86¢ $9.6M $664.1K Active
... and 62 more markets
Example social market Yes 0¢ / No 100¢ $7.6M $62.4K Active
... and 27 more markets
Example macro market Yes 0¢ / No 100¢ $7.0M $6.0M Active
... and 3 more markets
Example NBA MVP market Yes 42¢ / No 58¢ $3.6M $143.3K Next season
... and 30 more markets
Example politics market Yes 0¢ / No 100¢ $5.0M $143.4K Active
... and 54 more markets
Filter by category:
Market Odds Vol 24h Liquidity Ends
-----------------------------------------------------------------------------------------------------
Will the price of Bitcoin be above $70,000... Yes 0¢ / No 100¢ $846.8K $478.2K Feb 27
... and 8 more markets
Will Bitcoin reach $75,000 in February? Yes 0¢ / No 100¢ $807.0K $128.0K Mar 01
... and 20 more markets
Will the price of Ethereum be above $1,700... Yes 100¢ / No 0¢ $212.9K $403.3K Feb 27
... and 8 more markets
Search for a specific topic:
Markets (10 results)
Market Odds Vol 24h Liquidity
-----------------------------------------------------------------------------------------
Will the price of Bitcoin be above $58,000... Yes 100¢ / No 0¢ $4.5M $4.9M
Will the price of Bitcoin be above $60,000... Yes 100¢ / No 0¢ $4.5M $4.9M
Will the price of Bitcoin be above $64,000... Yes 100¢ / No 0¢ $4.5M $4.9M
Will the price of Bitcoin be above $66,000... Yes 0¢ / No 100¢ $4.5M $4.9M
Will Bitcoin reach $150,000 in February? Yes 0¢ / No 100¢ $3.1M $7.0M
Will Bitcoin dip to $55,000 in February? Yes 1¢ / No 99¢ $3.1M $7.0M
...
6. Research a Market¶
Pick a slug from bullpen polymarket discover --limit 5 or
bullpen polymarket search <query> and drill in:
bullpen polymarket event <EVENT_SLUG>
bullpen polymarket price <MARKET_SLUG>
bullpen polymarket trades <MARKET_SLUG>
bullpen polymarket holders <MARKET_SLUG>
7. Place a Trade¶
Preview first (no execution):
Order Preview
───────────────────────────────────
Action: Buy No
Market: Example active market
Amount: $5.00
Price: 1.7¢
Est. Shares: 294.11
Potential: $294.11
Trading Fee: $0.01
Network Fee: ~$0.01
Total Cost: $5.02
Spread: 99.8¢
───────────────────────────────────
Execute:
Place a limit order:
8. Manage Positions & Orders¶
View your positions:
Portfolio Value: $89.80 | Cash: $0.00 | Unrealized P&L: +$4.37
Market Outcome Shares Avg Price Value P&L P&L %
------------------------------------------------------------------------------------------------------
Will the New York Knicks win the NBA … Yes 36.0 14¢ 14¢ 5.22 +$0.17 3.5%
Will the Denver Nuggets win the NBA W… Yes 33.0 15¢ 16¢ 5.11 +$0.16 3.3%
US recession by end of 2026? Yes 28.9 23¢ 22¢ 6.21 -$0.56 -8.2%
Will the Oklahoma City Thunder win th… Yes 18.8 36¢ 36¢ 6.70 -$0.04 -0.6%
Will Solana dip to $60 in February? No 13.5 75¢ 99¢ 13.47 +$3.32 32.7%
Will Bitcoin dip to $55,000 in Februa… No 13.5 74¢ 99¢ 13.41 +$3.42 34.2%
S&P 500 all time high by March 31, 20… Yes 8.3 60¢ 55¢ 4.58 -$0.41 -8.3%
Will Jesus Christ return before GTA V… Yes 5.0 48¢ 48¢ 2.42 +$0.02 1.0%
...
View open orders:
Market ID Outcome Side Price Size Filled Type
--------------------------------------------------------------------------------------------------
Will Kon Knueppel win the… 0x93fb842… Yes BUY 8¢ 5.00 0.00 GTC
...
View trade history:
Activity (showing 5)
Time Type Market Side Amount USDC
──────────────────────────────────────────────────────────────────────────────────────
2026-02-27T18:34:09 TRADE Will the Denver Nuggets win the… BUY 10.0 $1.50
2026-02-27T17:14:07 TRADE Will the Denver Nuggets win the… BUY 13.0 $1.95
2026-02-27T16:31:03 TRADE Will the Denver Nuggets win the… BUY 10.0 $1.50
2026-02-27T14:35:23 TRADE Will the New York Knicks win th… BUY 16.6 $2.32
2026-02-27T14:35:23 TRADE Will the Detroit Pistons win th… BUY 0.6 $0.14
9. Leaderboard & Trader Intelligence¶
View the weekly leaderboard:
# Username Address Volume P&L Win Rate Trades
-----------------------------------------------------------------------------------------------
1 gmanas 0xe90b...5da2 $22.9M +$1.7M - -
2 lfc123 0xb904...c255 $4.8M +$749.2K - -
3 joosangyoo 0x07b8...8e25 $8.4M +$540.3K - -
4 0x1979ae6B7E6534dE9c4539D0c20… 0x1979...7c9d $31.5M +$459.4K - -
5 gopatriots 0xe20a...e469 $4.5M +$415.5K - -
6 predictorxyz 0x1d9a...426d $540.3K +$410.4K - -
7 0x6a57D263cD7c8EbA88b857eDEB7… 0x6a57...2afa $1.7M +$392.0K - -
8 kch123 0x6a72...33ee $1.6M +$389.1K - -
9 GamblingIsAllYouNeed 0x507e...beae $11.6M +$354.8K - -
10 0x054eC2F0cCfdaE941886a3eD306… 0x054e...6639 $1.7M +$354.2K - -
View the daily leaderboard:
# Username Address Volume P&L Win Rate Trades
-----------------------------------------------------------------------------------------------
1 weflyhigh 0x03e8...1697 $430.4K +$400.4K - -
2 Countryside 0xbddf...c684 $610.9K +$346.1K - -
3 kch123 0x6a72...33ee $352.4K +$167.6K - -
4 joosangyoo 0x07b8...8e25 $772.8K +$150.0K - -
5 0x24357454d8d1a0cc93a6c25fd49… 0x6e82...752c $135.6K +$127.8K - -
10. Trade Feed¶
Watch the live trade feed filtered to large trades:
Filtered Trades (10 total, page 1)
Market Side Price Size Trader PnL Tracked
--------------------------------------------------------------------------------
Will Leverkusen win the 202… SELL 1¢ $591 -$314 -
Example macro market BUY 4¢ $2.6K $0 -
Will Wolverhampton Wanderer… BUY 80¢ $798 $760 -
Ethereum Up or Down - Febru… SELL 7¢ $643 -$109 -
RC Strasbourg Alsace vs. Ra… BUY 68¢ $2.0K $4.3M -
Bitcoin Up or Down - Februa… BUY 59¢ $508 -$6.2K -
Example social market BUY 0¢ $8.1K -$65 -
11. Watchlist¶
Add Prediction, Onchain (Solana), or Perps items to your watchlist:
bullpen tracker watchlist add-polymarket <MARKET_SLUG>
bullpen tracker watchlist add-solana <MINT_ADDRESS>
bullpen tracker watchlist add-hyperliquid --symbol BTC --kind perp
View your watchlist:
12. JSON Output & Scripting¶
Most data and automation commands support --output json for programmatic use.
Raw output commands such as bullpen completion, interactive commands such as
bullpen shell, and unsupported streaming previews reject JSON mode. Check the
per-command reference page before wiring a command into automation.
bullpen polymarket positions --output json | jq '.positions[:3] | .[] | {market: .title, outcome, pnl, pnl_pct}'
13. Interactive Shell¶
Launch the REPL — runs commands without the bullpen prefix:
Inside the shell:
bullpen> polymarket discover --limit 5
bullpen> polymarket price <MARKET_SLUG>
bullpen> portfolio overview
bullpen> exit
For the full-screen terminal UI, run bullpen with no arguments. See the TUI Guide for layout, key bindings, slash commands, and exit shortcuts.
14. Upgrade¶
If an upgrade reports local credential or salt corruption, run
bullpen doctor auth --output json first and preserve the output if you need
support to inspect copied-home state. Restore the matching salt first only if
you need to keep the old local session. Otherwise run bullpen login; it moves
unreadable local auth files aside and starts a fresh session. Use
bullpen logout --force && bullpen login only as a last-resort local reset.
Most upgrades preserve the session as long as local credentials and refresh
tokens remain valid.
Release Notes¶
For the most recent release notes, see the CHANGELOG. Run bullpen --version to see your installed version, and bullpen upgrade to update. Homebrew and npm installs delegate to the package manager before checking GitHub releases. Homebrew recovery: brew update, brew upgrade bullpen, then brew link --overwrite bullpen; if Homebrew asks whether the Bullpen formula is trusted, run brew trust --formula bullpenfi/tap/bullpen and retry. npm recovery: npm install -g @bullpenfi/cli@latest.
Demo Tips¶
--previewon trading commands shows what would happen without executing — great for demos.--output json | jq .on JSON-capable commands to show structured data.bullpen shellfeels like a native trading terminal — impressive for live demos.bullpenopens the full-screen TUI when you want scrollback and autocomplete; see the TUI Guide.- Tab completion:
bullpen completion zsh >> ~/.zshrc && source ~/.zshrc. - For demos, pick any high-liquidity active market from
bullpen polymarket discover --limit 5; avoid hard-coding event-dated slugs in docs.