> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openvinyl.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI

> ov: look up vinyl records from your terminal and connect your agent in one command.

`ov` is a single shell script. It needs only `curl`, and pretty-prints JSON with `jq` or `python3` if you have them.

```bash theme={null}
curl -fsSL https://openvinyl.dev/install.sh | sh   # installs to ~/.local/bin/ov
ov barcode 093624952176
```

No key needed. If you've been given one for a higher limit, `ov login <key>` saves it (or set `OPEN_VINYL_KEY`).

## Commands

| Command | Does |
| - | - |
| `ov barcode 0 93624 95217 6` | Album(s) for a barcode, with the pressings that match |
| `ov search radiohead amnesiac` | Find albums by artist and/or title |
| `ov album m10362` | One album |
| `ov pressings m10362 --country US --year 1973 --label Harvest` | An album's pressings, with facets |
| `ov code --runout "SMAS-1-11163 F2"` | Pressings by catalog number, runout or barcode |
| `ov pressing 37867968` | Everything about one pressing |
| `ov me` | Your rate limit |
| `ov agent claude` | Add the Open Vinyl MCP server to Claude Code |
| `ov agent json` | Print MCP config for Cursor, Claude Desktop and others |
| `ov agent prompt` | Print a prompt that gives any agent access |

Output is JSON. Add `--raw` to skip pretty-printing, for example to pipe into `jq`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.