mixn/dotfiles/bullpen-cli

Bullpen CLI Skill

This is a live example of the AI agent skill format. For the full format specification, see AI Agent Skill Format Specification.

Instructions

Quick Start (if user is new)

If the user hasn't set up Bullpen yet, guide them through these 4 steps:

1. Install CLI: brew install bullpenfi/tap/bullpen
2. Install AI skills: bullpen skill install
3. Log in: bullpen login
4. Restart Claude/Codex so it picks up the new skills, then ask it anything

To update an existing install: bullpen upgrade (updates the binary and skills automatically).

Step 1: Identify What the User Wants to Do

Route to the right reference based on the user's intent:

Getting started (install, authenticate, configure, install skills):

• references/getting-started.md

Find and research markets (discover, search, events, prices, tags, series):

• references/discovery-and-research.md

Trade (buy, sell, limit orders, redeem, CTF split/merge, bridge funds):

• references/trading.md

Manage portfolio and orders (positions, open orders, cancel, watchlist, activity):

• references/portfolio-and-orders.md

Social and signals (comments, feeds, alerts, tracker, leaderboard):

• references/social-and-signals.md

Account and platform (auth, config, portfolio balances, points, status):

• references/platform-and-account.md

Wallet management (list wallets, select primary, switch chains):

• references/platform-and-account.md

Step-by-step tutorials (complete workflows with exact commands):

• references/trading-tutorial.md — discover → trade → manage → redeem
• references/copy-trading-tutorial.md — find traders → copy → monitor → manage
• references/tracker-tutorial.md — track wallets → groups → watchlist → alerts

Scripting and automation (JSON output, jq piping, batch workflows):

• references/scripting-and-automation.md

Bracket contests (March Madness, tournament picks, fill bracket, leaderboard):

• references/bracket-contest.md

Community and support (Discord, X/Twitter, file a ticket, report a bug):

• references/community.md

Diagnostics and troubleshooting (collect system info, debug errors, file support tickets):

• references/diagnostics.md

Troubleshooting (deposit not showing, wrong asset, account access, CLI errors):

• references/troubleshooting.md

Many tasks span multiple categories. Read all relevant references before acting.

Step 2: Key Rules

Before running any command, keep these rules in mind:

• All commands support `--output json` for machine-readable output. Default is table.
• Trading commands require `--yes` to skip interactive confirmation (essential for automation).
• Authentication is required for any write operation (trading, orders, alerts, comments).
• Read-only operations (discover, search, price, event, leaderboard) work without auth.
• Market slugs are the primary identifier (e.g., will-bitcoin-hit-100k), not numeric IDs.
• Outcomes are specified by name: Yes, No, or the outcome text for multi-outcome markets. Aliases work too: Y/N, True/False, 1/0.
• Prices are 0.01-0.99 (representing cents per share / probability).
• Global flags: --env staging|production, --config <path> work on all commands.

Step 3: Execute

Run commands via bullpen CLI. If the CLI is not installed, start with references/getting-started.md.

Quick Command Map

Use this for simple queries without reading full references:

Examples

Example 1: First-Time Setup and First Trade

User says: "Set up Bullpen and buy Yes on the Bitcoin market"

Actions:

1. Install: brew install bullpenfi/tap/bullpen
2. Log in: bullpen login
3. Verify: bullpen status
4. Find the market: bullpen polymarket search "bitcoin"
5. Check the price: bullpen polymarket price will-bitcoin-hit-100k
6. Buy shares: bullpen polymarket buy will-bitcoin-hit-100k Yes 10 --yes
7. Verify position: bullpen polymarket positions

Example 2: Market Research Workflow

User says: "Research the most active prediction markets"

Actions:

1. Discover trending: bullpen polymarket discover --sort volume --limit 10 --output json
2. Pick an event and drill down: bullpen polymarket event <SLUG> --output json
3. Check pricing: bullpen polymarket price <SLUG> --output json
4. View recent trades: bullpen polymarket trades <SLUG> --output json
5. Check top holders: bullpen polymarket holders <SLUG> --output json
6. Check smart money: bullpen polymarket data smart-money --output json

Example 3: Execute a Buy and Verify

User says: "Buy $50 of Yes shares on will-trump-win and show me the position"

Actions:

1. Preview the order: bullpen polymarket buy will-trump-win Yes 50 --preview
2. Execute: bullpen polymarket buy will-trump-win Yes 50 --yes
3. Check position: bullpen polymarket positions --output json

Example 4: Set Up Smart Money Alerts

User says: "Alert me when whales trade on crypto markets"

Actions:

1. Enable smart alerts: bullpen polymarket smart-alerts --set --smart-money true --top-traders true --categories crypto
2. Track specific traders: bullpen tracker add <ADDRESS>
3. Check current alerts: bullpen polymarket smart-alerts --output json

Example 5: Automated Portfolio Monitoring

User says: "Script that checks my positions and finds markets to trade"

# Check positions
bullpen polymarket positions --output json | jq '.positions[] | {market: .title, shares: .size, value: .current_value}'
 
# Find high-volume active markets
bullpen polymarket discover --sort volume --min-liquidity 100000 --output json | jq '.markets[] | {title, volume, liquidity}'
 
# Check prices on watchlist
bullpen tracker watchlist --output json | jq -r '.markets[].slug' | while read slug; do
  bullpen polymarket price "$slug" --output json
done
 
# Get leaderboard for strategy ideas
bullpen polymarket data leaderboard --period week --limit 5 --output json

Troubleshooting