Command Reference
Complete reference for the requesthunt CLI.
Global Flags
| Flag | Description |
|---|---|
| --json | Output raw JSON instead of TOON |
| --human | Output table/key-value summaries for terminal operators |
| --api-key <KEY> | Override env and config for the current command (browser-login credentials still take precedence) |
Authentication
requesthunt auth login
Open the browser approval flow, poll for approval (up to 10 min), and save credentials locally. This is the primary authentication method.
$ requesthunt auth login
Opening browser for approval...
Waiting for approval (expires in 10 minutes)...
Login successful! Stored credentials for alice@example.comrequesthunt auth status
Show the current logged-in user from credentials.json, or prompt to log in if no credentials exist.
requesthunt auth logout
Remove the saved browser-login credentials.
Search & List
requesthunt search <QUERY>
Full-text search across all feature requests.
| Flag | Description |
|---|---|
| --limit <N> | Max results (1-100, default: 20) |
| --expand | Enable AI topic expansion + realtime scraping |
| --platforms reddit,x,github | Filter by platform |
requesthunt search "dark mode" --limit 5
requesthunt --json search "browser automation" --expand --platforms reddit,xrequesthunt list
Browse requests with filters and pagination.
| Flag | Description |
|---|---|
| --topic <TOPIC> | Filter by topic (e.g., "kanban") |
| --category <SLUG> | Filter by category slug |
| --platforms reddit,x,github,requesthunt | Filter by platform |
| --sort new|top | Sort order |
| --cursor <CURSOR> | Pagination cursor from previous response |
requesthunt list --topic kanban --sort top --limit 10
requesthunt list --platforms reddit,requesthunt --cursor CURSOR_FROM_PREVIOUS_PAGEScraping
requesthunt scrape start <TOPIC>
Start an async scrape job to collect fresh results. Omit --platforms to use all realtime platforms.
| Flag | Description |
|---|---|
| --platforms reddit,x,github | Platforms to scrape |
| --depth 1-40 | Scraping depth (higher = more results, more credits) |
requesthunt scrape start "developer onboarding" --platforms reddit,x --depth 2requesthunt scrape status <JOB_ID>
Check scrape job progress, completion, and per-platform status.
Utility
requesthunt topics
List available categories and topics. Use these to filter search and list results.
requesthunt usage
Show current tier, credit usage, API key usage, and rate limits.
requesthunt config set-key <KEY>
Save a manual API key to the local config file for CI or automation.
requesthunt config show
Show the config path plus masked stored and resolved API keys.