releasehound

Official command-line interface for ReleaseHound.

releasehound gives you terminal access to ReleaseHound's App Store competitive intelligence data so you can inspect competitor apps, monitor releases, reviews, ratings, and feed activity, and script those workflows for agents or automation without opening the web app.

It is useful for:

• checking competitor release notes, reviews, ratings, and other App Store signals from the terminal
• scripting ReleaseHound workflows in CI, local automation, and agent loops
• giving coding agents a fast way to query structured tracked-app data with --json

Install

npm install -g releasehound

Or run it without a global install:

npx releasehound --help

The package installs two binaries:

• rh
• releasehound

Requirements

• Node.js 18 or newer
• A ReleaseHound account

Authentication

The recommended path is browser login:

rh login

For non-interactive environments, you can also set RELEASEHOUND_TOKEN:

export RELEASEHOUND_TOKEN=your_token_here

Optional:

export RELEASEHOUND_BASE_URL=https://releasehound.com

Quick Start

rh whoami
rh apps
rh get "Notion"
rh reviews "Notion" --limit 10
rh releases "Notion" --json
rh track "https://apps.apple.com/us/app/notion-notes-projects-docs/id1232780281"

Common Commands

rh login
rh logout
rh whoami
rh apps --json
rh feed --limit 10
rh reviews <selector>
rh releases <selector>
rh rating-history <selector> --days 30
rh track <query-or-url>
rh untrack <selector> --yes
rh doctor

Selectors can be friendly values like an app name, App Store ID, bundle ID, ReleaseHound app ID, or exact App Store URL.

Output Modes

Most commands default to human-readable text output and also support:

• --json
• --table where applicable

Notes

• The current CLI package is focused on iOS App Store tracking.
• Browser login is the default auth flow; RELEASEHOUND_TOKEN is optional for agents, CI, and other automation.

Docs

• rh --help
• rh <command> --help
• API base: https://www.releasehound.com/api/v1