CLI

requesthunt is a Rust CLI for authenticated access to the RequestHunt API. It is designed for both human terminal use and agent workflows.

Installation

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

Downloads the right binary for your OS/architecture and installs it into /usr/local/bin or ~/.local/bin.

From source
# Or build from source
cargo install --path cli

# Or build a release binary without installing
cargo build --manifest-path cli/Cargo.toml --release

Output Formats

Three output modes to fit different contexts:

TOON (default)

Token-Oriented Object Notation. Structured like JSON but without braces, commas, and repeated quoting. Cheaper for LLM context windows while preserving the response shape.

$ requesthunt config show
config_path: /Users/alice/.config/requesthunt/config.toml
stored_api_key: null
resolved_api_key: rh_l...1234
api_key_source: env

JSON --json

Pretty-printed JSON when exact payloads are required.

$ requesthunt --json config show
{
  "config_path": "/Users/alice/.config/requesthunt/config.toml",
  "stored_api_key": null,
  "resolved_api_key": "rh_l...1234",
  "api_key_source": "env"
}

Human --human

Table and key-value summaries for terminal operators.

$ requesthunt --human config show
Config path:      /Users/alice/.config/requesthunt/config.toml
Stored API key:   not set
Resolved API key: rh_l...1234
API key source:   env

Credential Resolution

The CLI resolves API credentials in this order (highest priority first):

  1. Browser login requesthunt auth login stores credentials in credentials.json
  2. CLI flag --api-key <KEY>
  3. Environment variable REQUESTHUNT_API_KEY
  4. Config file requesthunt config set-key

Config Paths

PlatformPath
macOS~/Library/Application Support/requesthunt/
Linux~/.config/requesthunt/

Contains credentials.json (from auth login) and config.toml (from config set-key).