🏟 Product Arena CLI

A command-line tool for interacting with the Product Arena API — vote on products, manage your Hits, Misses & TBD lists, manage bookmarks, explore leaderboards, and post comments.

Installation

Install globally from npm:

npm install -g productarena-cli

Or install from source:

git clone https://github.com/haofanwang/productarena-cli.git
cd productarena-cli
npm install
npm link

Quick Start

# 1. Set your API key (get one at https://www.productarena.co/docs)
productarena config set-key pa_your_key_here

# 2. Verify it works
productarena whoami

# 3. Explore the leaderboard
productarena leaderboard

Usage

Configuration

# Save your API key
productarena config set-key pa_xxxx

# Set a custom base URL
productarena config set-url https://www.productarena.co

# View current config
productarena config show

You can also use environment variables:

• PRODUCTARENA_API_KEY — overrides the saved API key
• PRODUCTARENA_BASE_URL — overrides the saved base URL

Products

# List your Hits, Misses & TBD
productarena products list

# Filter by type
productarena products list --type hits
productarena products list --type tbd

# Add a product to Hits
productarena products add https://cursor.com --type hits

# Add a product to TBD
productarena products add https://example.com --type tbd

# Add with a category
productarena products add https://suno.ai --type hits --category audio

# Remove a product
productarena products remove https://cursor.com

# Remove by domain
productarena products remove cursor.com --by domain

Bookmarks

# List your bookmarks
productarena bookmarks list

# Bookmark a URL
productarena bookmarks add https://example.com

# Remove a bookmark by ID
productarena bookmarks remove clx...

Leaderboard

# Full leaderboard
productarena leaderboard

# Top hits this week
productarena leaderboard --sort hits --range 1w

# Filter by category, show top 10
productarena leaderboard --category agent --limit 10

Comments

# View comments for a product
productarena comments list cursor.com

# Post a comment
productarena comments add cursor.com "Amazing code editor!"

Other

# Platform stats
productarena stats

# Test your API key (shows hits, misses, and tbd counts)
productarena whoami

# Version info
productarena --version

Global Options

Every command supports these flags:

# Override API key for a single command
productarena --key pa_xxxx products list

# Override base URL
productarena --base-url https://www.productarena.co leaderboard

License

MIT