> For the complete documentation index, see [llms.txt](https://docs.bullpen.fi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bullpen.fi/bullpen-cli/overview.md).

# Overview

Trade Polymarket from your terminal, or let AI agents trade for you.

## Bullpen CLI

Bullpen CLI gives you market discovery, order entry, portfolio tools, and smart money data from the terminal.

{% embed url="<https://www.youtube.com/watch?t=19s&v=-F0dZ2GxSuA>" %}

> Bullpen CLI is in Beta. Commands may change between releases. Report bugs at [github.com/BullpenFi/bullpen-cli-releases/issues](https://github.com/BullpenFi/bullpen-cli-releases/issues).

### Requirements

| OS      | Version                    |
| ------- | -------------------------- |
| macOS   | 12+                        |
| Linux   | Ubuntu 20.04+ / Debian 10+ |
| Windows | 11 via WSL2                |

### Install

**Homebrew (macOS / Linux)**

```
brew install BullpenFi/tap/bullpen
```

**npm**

```
npm install -g @bullpenfi/cli
```

**Shell Script**

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

**Manual Download**

Download from [GitHub Releases](https://github.com/BullpenFi/bullpen-cli-releases/releases).

**Windows** Install WSL2 first, then use any of the methods above inside your WSL terminal.

If `bullpen` is not found after install, make sure the install location is on your PATH.

Update anytime: `bullpen upgrade`

### Log In

```
bullpen setup
```

This handles config, login, and Polymarket approvals in one step. A code and URL appear in your terminal. Open the URL in your browser, enter the code, done.

You can also do each step separately:

```
bullpen config init
bullpen login
```

Confirm you're connected:

```
bullpen status
```

### Your First Trade

```
bullpen polymarket discover --limit 5          # browse trending markets
bullpen polymarket search "bitcoin"            # search for a topic
bullpen polymarket price will-btc-reach-100k   # check the price
bullpen polymarket buy will-btc-reach-100k "Yes" 10 --preview   # preview (no money moves)
bullpen polymarket buy will-btc-reach-100k "Yes" 10 --yes       # execute
bullpen polymarket positions                   # check your position
```

Polymarket requires one-time approvals before your first trade. `bullpen setup` handles this, but if you skipped it:

```
bullpen polymarket approve --yes
```

## Interactive Mode

Run `bullpen` with no arguments for a full-screen terminal UI. No commands to memorize.

You can also use the interactive shell to skip typing `bullpen` on every command:

```
bullpen shell
```

```
bullpen> polymarket discover --limit 5
bullpen> polymarket price will-btc-reach-100k
bullpen> exit
```

Tab completion:

```
bullpen completion zsh >> ~/.zshrc && source ~/.zshrc
```

### What's in the CLI

| Feature         | What You Get                                                                              |
| --------------- | ----------------------------------------------------------------------------------------- |
| **Markets**     | Discover, search, filter, and inspect prices, trades, holders, comments, and leaderboards |
| **Trading**     | Buy, sell, place limit orders, and redeem resolved positions                              |
| **Smart Money** | Follow traders, filter trade feeds by P\&L and volume, and set alerts                     |
| **Portfolio**   | Balances and P\&L across Polymarket, Solana, and Hyperliquid                              |
| **Bridge**      | Deposit and withdraw through the Polymarket bridge                                        |
| **Points**      | Check points, view rewards, and claim payouts                                             |
| **Scripting**   | `--output json` support on every read command                                             |

### Configuration

Config lives at `~/.bullpen/config.toml`.

```
bullpen config init      # generate default config
bullpen config show      # view current config
```

### Uninstall

```
bullpen skill uninstall --yes       # remove AI skills (if installed)
brew uninstall bullpen              # remove binary (Homebrew)
npm uninstall -g @bullpenfi/cli     # remove binary (npm)
rm "$(which bullpen)"              # remove binary (shell / manual)
rm -rf ~/.bullpen                   # remove local data, credentials, config
```

> Bullpen CLI is in Beta. Commands may change between releases. Report bugs at [github.com/BullpenFi/bullpen-cli-releases/issues](https://github.com/BullpenFi/bullpen-cli-releases/issues).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.bullpen.fi/bullpen-cli/overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.