@redditgrow/cli

Command-line interface for RedditGrow. 18 command groups covering Reddit opportunities, cold DM outreach, SEO/SERP intel, brand mentions, a 10-day warmup roadmap, and an autopilot that picks your next best action.

Install

npm install -g @redditgrow/cli

Requires Node.js 18+.

Authenticate

1. Go to Settings → Integrations and generate an API key.
2. Run:

   redditgrow auth rg_live_xxxxxxxxxxxx

   The key is saved to ~/.redditgrow/config.json (chmod 600). You can also set REDDITGROW_API_KEY to override (useful for CI).

Command groups

Run redditgrow <group> --help for subcommands. Most commands accept --format json for machine-readable output.

| Group | Purpose | |---|---| | opps | List, show, mark done/skip/saved opportunities | | generate | Generate a single reply (tone × length × angle) | | variants | A/B test reply variants + record outcomes + winning patterns | | drafts | Save and list drafts | | dms | Cold DM outreach — prospects, generate, queue, cancel, stats | | roadmap | 10-day warmup roadmap (today, week, mark, regenerate) | | mentions | Brand + competitor mention monitoring | | seo | SERP rank, ranking opps, money keywords, SEO opportunities, AI visibility | | subreddits | Discover, analyze, best-times + full tracked-subs CRUD | | reddit | Live Reddit search + post fetch + user profile | | projects | List and create RedditGrow projects | | accounts | List Reddit accounts + set the active one | | webhooks | Subscribe / test / delete webhooks (HMAC-signed) | | templates | Reusable tone + length + angle presets | | warmup | Quick or detailed account-health report | | setup | Conversational onboarding from a URL or description | | next | Autopilot — prioritized next best action across every signal | | auth | Manage your API key |

Common recipes

# Morning brief — what should I do today?
redditgrow next

# Top opportunities
redditgrow opps list --min-score 80 --limit 5

# A/B test variants
redditgrow variants generate <opp-id> --count 3
redditgrow variants outcome <draft-id> --karma 42 --replies 3
redditgrow variants patterns

# Cold DM
redditgrow dms generate <opp-id> --angle pain
redditgrow dms queue <prospect-id>
redditgrow dms stats

# SEO leverage
redditgrow seo rank "best crm for agencies"    # live Google SERP
redditgrow seo opportunities --min-volume 100  # prioritized SEO-leverage replies
redditgrow seo visibility "Acme Inc"           # 0-100 brand-visibility score

# Daily warmup plan
redditgrow roadmap today
redditgrow roadmap mark <item-id> completed

# Brand monitoring
redditgrow mentions competitors --unseen

# Webhooks
redditgrow webhooks create --name "Slack" --url "https://hooks.slack.com/..."
redditgrow webhooks test <subscription-id>

# Project setup from a URL
redditgrow setup from-landing https://acme.com

# Any command → JSON
redditgrow opps list --format json | jq '.[].id'

Agency example: morning brief per client

#!/bin/bash
# clients.txt = one API key per line
while IFS= read -r key; do
  REDDITGROW_API_KEY=$key redditgrow next --format json \
    > "briefs/$(date +%F)_${key:0:12}.json"
done < clients.txt

next aggregates every signal (warmup, hot opps, mentions, scheduled DMs, roadmap) into one prioritized recommendation — perfect for a daily client digest.

Plans + rate limits

• Growth ($39/mo) — 100 calls/h, 1 API key
• Agency ($99/mo) — 500 calls/h, 5 API keys
• Founder Pack — not eligible (upgrade required)

Exceeding the rate limit returns HTTP 429 with a Retry-After header.

License

Proprietary — see redditgrow.ai/terms.