Reddit intelligence CLI for AI agents. Use when working with reddit posts, subreddit research, comments, user profiles, wiki pages, domain mentions, marketin...
Reddit API access for AI agents. All commands output JSON to stdout. Errors go to stderr with exit code 1.
# Install
npm install -g @reddgrow/cli
# Authenticate (one-time)
reddgrow auth login rg_your_api_key_here
# Or use environment variable
export REDDGROW_API_KEY=rg_your_api_key_here
reddgrow subreddits search "<query>" [--limit N] # (3 cr)
reddgrow subreddits about <name> # (1 cr)
reddgrow subreddits rules <name> # (1 cr)
reddgrow subreddits wiki <name> # list wiki pages (5 cr)
reddgrow subreddits wiki-page <name> <page> # read wiki page (5 cr)
reddgrow subreddits posts <name> [--sort hot|new|top|rising|controversial] [--time hour|day|week|month|year|all] [--limit N] # (2 cr)
reddgrow subreddits comments <name> [--limit N] # comment stream (2 cr)
reddgrow subreddits check-url <name> "<url>" # check if URL submitted (3 cr)
reddgrow subreddits traffic <name> # traffic stats (1 cr)
reddgrow subreddits widgets <name> # sidebar widgets (1 cr)
reddgrow posts search "<query>" [--subreddit <name>] [--sort relevance|hot|top|new|comments] [--limit N] # (3 cr)
reddgrow posts comments <subreddit> <post_id> [--sort best|top|new|controversial] [--limit N] # (2 cr)
reddgrow posts duplicates <subreddit> <post_id> # (5 cr)
reddgrow posts batch <id1,id2,...> # (5 cr)
reddgrow users profile <username> # karma, account age, activity (1 cr)
reddgrow users posts <username> [--limit N] # post history (2 cr)
reddgrow users comments <username> [--limit N] # comment history (2 cr)
reddgrow domains mentions <domain> [--limit N] # all posts linking to domain (5 cr)
reddgrow auth whoami # identity & credits remaining (1 cr)
reddgrow auth status # connection status
reddgrow auth login <key> # save API key (run once)
reddgrow subreddits rules <name> — rule violations get posts removed instantlyreddgrow subreddits about <name> — if subreddit_type is restricted or private, stop; if submission_type is link or self, respect itreddgrow subreddits check-url <name> "<url>"reddgrow subreddits wiki-page <name> indexreddgrow subreddits search "<topic>"reddgrow subreddits about <name> — size, type, activityreddgrow subreddits posts <name> --sort top --time week --limit 50reddgrow subreddits traffic <name>reddgrow subreddits wiki <name> then wiki-page <name> <page>reddgrow domains mentions <domain> --limit 100reddgrow posts comments <subreddit> <post_id> --sort bestreddgrow subreddits check-url <name> "<url>" before re-sharingreddgrow users profile <username> — karma, age, verified statusreddgrow users posts <username> --limit 50reddgrow users comments <username> --limit 50reddgrow subreddits rules <name> before posting — rule violations get posts removedreddgrow subreddits check-url <name> "<url>" before sharing any link — duplicate posts are bannedwiki-page <name> index) when rules reference additional guidelinessubreddit_type: restricted or private means posting is not allowedsubmission_type: some subreddits only accept links or only text postsreddgrow auth whoami before large batch operations to avoid credit exhaustion| Variable | Description | Default |
|---|---|---|
REDDGROW_API_KEY | API key (overrides saved key) | — |
REDDGROW_API_URL | API base URL | https://api.reddgrow.ai |
REDDGROW_MODE | Output mode (human or json) | json |
ZIP package — ready to use