What is ReddGrow?

68% of AI-generated answers cite Reddit. ReddGrow is a Reddit intelligence platform that finds the conversations that matter — and the CLI gives AI agents direct access to that data.

Manage campaigns, advocates, and drafts. Monitor brand mentions. Search subreddits, read posts and comments, analyze user profiles, track domain mentions, and check posting rules — all through a clean JSON API designed for agent workflows.

→ reddgrow.ai

Get Your API Key

1. Sign up at reddgrow.ai
2. Go to Settings → API Keys
3. Create a new key — it starts with rg_
4. Use it with the CLI or set the environment variable:

reddgrow auth login rg_your_api_key_here
# or
export REDDGROW_API_KEY=rg_your_api_key_here

Install

npm install -g @reddgrow/cli

yarn global add @reddgrow/cli

pnpm add -g @reddgrow/cli

bun add -g @reddgrow/cli

Quick Start

# 1. Install globally
npm install -g @reddgrow/cli

# 2. Authenticate
reddgrow auth login rg_your_api_key_here

# 3. Fetch trending posts from any subreddit
reddgrow reddit subreddits posts typescript --sort top --time week

Commands

Auth

| Command | Description | |---------|-------------| | reddgrow auth login <key> | Save your API key | | reddgrow auth whoami | Show identity and credit balance | | reddgrow auth status | Show connection status | | reddgrow auth logout | Remove saved API key |

Campaigns

| Command | Description | |---------|-------------| | reddgrow campaigns list | List all campaigns | | reddgrow campaigns get <id> | Get a campaign by ID | | reddgrow campaigns create | Create a new campaign | | reddgrow campaigns update <id> | Update a campaign | | reddgrow campaigns delete <id> | Delete a campaign |

Options for create / update: --name · --url · --mention-as · --description · --use-cases <s...> · --talking-points <s...> · --json <inline> · --json-file <path>

Subreddits (managed tracking)

| Command | Description | |---------|-------------| | reddgrow subreddits list | List tracked subreddits | | reddgrow subreddits get <id> | Get a tracked subreddit by ID | | reddgrow subreddits quick-add <name> | Quickly add a subreddit by name (e.g. r/foo or foo) | | reddgrow subreddits create | Create a fully-configured tracked subreddit | | reddgrow subreddits update <id> | Update a tracked subreddit | | reddgrow subreddits toggle <id> | Toggle active status | | reddgrow subreddits delete <id> | Remove a subreddit from tracking |

Options for quick-add: --campaign <id>
Options for create / update: --name · --tier · --category · --campaign <id> · --active/--no-active · --keywords <s...> · --json · --json-file

Advocates

| Command | Description | |---------|-------------| | reddgrow advocates list | List all advocates | | reddgrow advocates get <id> | Get an advocate by ID | | reddgrow advocates create | Create an advocate persona | | reddgrow advocates update <id> | Update an advocate persona | | reddgrow advocates delete <id> | Delete an advocate persona |

Options for create / update: --name · --role · --tone · --campaign-id <id> · --reddit-account-id <id> · --daily-drafts <n> · --employee-position · --custom-instructions · --json · --json-file

Brand Monitor (bm)

Domains

| Command | Description | |---------|-------------| | reddgrow brand-monitor domains list | List monitored domains | | reddgrow brand-monitor domains get <id> | Get a monitored domain by ID | | reddgrow brand-monitor domains add | Add a domain to monitor | | reddgrow brand-monitor domains update <id> | Update a monitored domain | | reddgrow brand-monitor domains remove <id> | Remove a domain from monitoring |

Options for add / update: --domain · --label · --primary · --brand-description · --search-keywords <s...> · --negative-keywords <s...> · --active/--no-active · --json · --json-file

Mentions

| Command | Description | |---------|-------------| | reddgrow brand-monitor mentions list | List brand mentions with filters | | reddgrow brand-monitor mentions get <id> | Get a mention by ID | | reddgrow brand-monitor mentions update <id> | Update mention status or sentiment |

Options for mentions list: --domain · --subreddit · --sentiment · --status · --intent · --red-flags · --is-brand-match · --from · --to · --min-score · --sort-by · --limit · --offset

Stats

| Command | Description | |---------|-------------| | reddgrow brand-monitor stats | Brand monitoring stats overview |

Options: --domain · --days (default 30)

Drafts

| Command | Description | |---------|-------------| | reddgrow drafts list | List drafts with optional filters | | reddgrow drafts get <id> | Get a draft by ID | | reddgrow drafts approve <id> | Approve a draft for posting | | reddgrow drafts skip <id> | Skip a draft (mark as not needed) |

Options for list: --status · --type · --campaign <id> · --advocate <id> · --after · --before · --sort-by (default created_at) · --sort-order (default desc) · --limit · --offset

Stats

| Command | Description | |---------|-------------| | reddgrow stats summary | Campaign and draft summary | | reddgrow stats daily | Daily draft volume time series | | reddgrow stats dashboard | Draft pipeline dashboard | | reddgrow stats posting | Posting activity and cooldown status |

Options for daily: -d/--days (default 30)
Options for posting: --timezone · --reddit-account <id>

Health

| Command | Description | |---------|-------------| | reddgrow health ping | Verify API connectivity and authentication |

Reddit Intelligence (reddit)

Read-only Reddit data. All commands are under the reddit namespace (alias: the sub-namespace aliases r, u, d work as shortcuts within reddit).

Subreddits (reddit subreddits, alias r)

| Command | Description | |---------|-------------| | reddgrow reddit subreddits search <query> | Find relevant communities (3 credits) | | reddgrow reddit subreddits about <name> | Get community info and stats (1 credit) | | reddgrow reddit subreddits rules <name> | Get posting rules (1 credit) | | reddgrow reddit subreddits posts <name> | Fetch the post feed (2 credits) | | reddgrow reddit subreddits comments <name> | Get recent comment stream (2 credits) | | reddgrow reddit subreddits wiki <name> | List wiki pages (5 credits) | | reddgrow reddit subreddits wiki-page <name> <page> | Read a wiki page (5 credits) | | reddgrow reddit subreddits widgets <name> | Get sidebar widgets (1 credit) | | reddgrow reddit subreddits traffic <name> | Get traffic statistics (1 credit) | | reddgrow reddit subreddits check-url <name> <url> | Check if URL was already posted (3 credits) |

Options for posts: --sort hot\|new\|top\|rising\|controversial · --time hour\|day\|week\|month\|year\|all · --limit <n>

Posts (reddit posts)

| Command | Description | |---------|-------------| | reddgrow reddit posts search <query> | Search posts across all of Reddit (3 credits) | | reddgrow reddit posts comments <subreddit> <id> | Get comments for a post (2 credits) | | reddgrow reddit posts duplicates <subreddit> <id> | Find duplicate submissions (5 credits) | | reddgrow reddit posts batch <id> [id...] | Fetch multiple posts at once (5 credits) |

Users (reddit users, alias u)

| Command | Description | |---------|-------------| | reddgrow reddit users profile <username> | Get user profile and karma (1 credit) | | reddgrow reddit users posts <username> | Get post history (2 credits) | | reddgrow reddit users comments <username> | Get comment history (2 credits) |

Domains (reddit domains, alias d)

| Command | Description | |---------|-------------| | reddgrow reddit domains mentions <domain> | Find Reddit posts linking to a domain (5 credits) |

Output Modes

ReddGrow auto-detects whether it's running interactively or piped, and adjusts output accordingly.

Human mode (interactive terminal) — rich, colored output:

  ┌─────────────────────────────────────────┐
  │  ✓ Connected to ReddGrow API            │
  │                                         │
  │  API Key    rg_abc6...ef12              │
  │  API URL    https://api.reddgrow.ai     │
  └─────────────────────────────────────────┘

Agent mode (piped / non-TTY) — raw JSON to stdout, errors to stderr:

{
  "id": "typescript",
  "subscribers": 312000,
  "title": "TypeScript",
  "description": "TypeScript is a language for application-scale JavaScript."
}

[!TIP] Mode is auto-detected when piping output. Force it explicitly with --mode agent or export REDDGROW_MODE=agent.

AI Agent Integration

ReddGrow ships a SKILL.md that Claude and other AI agents can consume via OpenClaw.

Claude / OpenClaw: The SKILL.md bundled in this package teaches your agent all commands, workflows, and credit costs automatically.

Pipe to jq:

# Get the top 5 post titles from r/typescript this week
reddgrow reddit subreddits posts typescript --sort top --time week | jq '.[0:5] | .[].title'

# Save subreddit info to a file
reddgrow reddit subreddits about typescript > typescript-info.json

# Check if a URL has been shared before posting
reddgrow reddit subreddits check-url typescript "https://mysite.com/article" | jq '.alreadyPosted'

Recommended workflow for agents:

# 1. Research the community
reddgrow reddit subreddits about <name>
reddgrow reddit subreddits rules <name>
reddgrow reddit subreddits wiki <name>

# 2. Check for duplicates before posting
reddgrow reddit subreddits check-url <name> "<url>"

# 3. Monitor your account
reddgrow auth whoami

Configuration

| Variable | Description | Default | |----------|-------------|---------| | REDDGROW_API_KEY | Your API key (overrides saved key) | — | | REDDGROW_API_URL | API base URL | https://api.reddgrow.ai | | REDDGROW_MODE | Output mode: human or agent | auto-detected |

Config is stored at ~/.reddgrow/config.json. The --mode flag and environment variables always take precedence over the saved config.

Links

• Website: reddgrow.ai
• npm: @reddgrow/cli

License

MIT © ReddGrow