Quickstart

Get productive with the RequestHunt CLI in under 2 minutes.

Agent Setup

If you're using an AI agent, skip the manual steps. Tell your agent:

One-liner setup prompt
Read https://requesthunt.com/setup.md and follow the instructions to set up RequestHunt.

The manual steps below are for humans setting up without an agent.

1. Install the CLI

Install
curl -fsSL https://requesthunt.com/cli | sh

Downloads the right binary for your OS and installs it to /usr/local/bin. Or build from source with cargo install --path cli.

2. Sign in

Authenticate
requesthunt auth login
# Opens your browser → approve → done

Browser-based login stores your API key and user profile locally. No manual key copying needed. For CI environments, see Authentication.

3. Search feature requests

Your first commands
# Search across Reddit, X, and GitHub
requesthunt search "dark mode" --limit 5

# List requests for a specific topic
requesthunt list --topic kanban --sort top

# Start a realtime scrape
requesthunt scrape start "developer onboarding" --platforms reddit,x

Default output is TOON (token-efficient for AI agents). Add --json for raw JSON or --human for terminal-friendly tables.

Verify your setup

requesthunt auth status   # check logged-in user
requesthunt config show   # see resolved API key source
requesthunt usage         # check your credit balance