Game Market Copilot CLI

gmc lets you use Game Market Copilot from your terminal or coding agent to research Steam games, compare peers, review market signals, and find relevant showcases.

Install

Install the CLI:

npm install -g @witchpot/gmc
gmc --version

Or run it without a global install:

npx @witchpot/gmc --version

The package installs three equivalent binaries: gmc, gmcp, and game-market-copilot. If gmc appears to run git instead of this CLI, a shell alias is shadowing it — Oh My Zsh's git plugin defines gmc='git merge --continue'. Use gmcp (or command gmc, or unalias gmc) in that shell.

A fuller user guide lives in docs/gmc-cli-user-guide.md.

Closed-beta access is controlled by GMC API credentials, not npm package visibility. Installing the public package does not grant access to paid or beta data. Authenticated access (login, API keys) requires a paid GMC plan (Starter or Pro) — see https://gamemarketcopilot.com/plans. Without credentials the CLI serves redacted public previews with a small quota.

Auth

Interactive browser login is the preferred local setup path:

gmc login
gmc auth status --json

Use API-key auth for CI, headless agents, or restricted browser environments:

gmc login --api-key <display-once workspace API key> --api-base-url https://gamemarketcopilot.com
gmc auth status --json

Non-interactive agents and CI can use environment variables:

export GMC_API_BASE_URL=https://gamemarketcopilot.com
export GMC_API_KEY=<display-once workspace API key>
# or
export GMC_CLI_CREDENTIAL=<display-once browser-login CLI credential>
gmc auth status --json

The CLI never prints the raw key or credential after login. Status and config output show only a non-secret prefix.

Agent Skill

The package bundles the gmc-analysis Agent Skill — analysis recipes, pivot heuristics, quota etiquette, honesty rules, and branded chart-card generation (publish-ready, correctly attributed charts from gmc output) for coding agents. The core analysis guidance is shared, but the registration step depends on the agent.

For Claude Code, install the packaged skill directory:

gmc skill install            # writes .claude/skills/gmc-analysis (project)
gmc skill install --global   # or ~/.claude/skills/gmc-analysis
gmc skill status --json      # packaged vs installed versions

For Codex and other AGENTS.md-based agents, append the self-contained edition (references inlined) to the repo brief the agent reads:

gmc skill print --format agents-md >> AGENTS.md

If AGENTS.md already contains a generated gmc-analysis section, update that section instead of appending a duplicate.

Re-run install/print after npm update to pick up newer skill versions.

First Queries

gmc schema --json
gmc tags --q roguelike --json
gmc update --json
gmc games search --source steam --release-year 2025 --reviews-min 1000 --fields title,appid,rating,reviews --json
gmc games aggregate --source steam --release-year 2025 --metric count,median_reviews --group-by release_year --reviews-min 1000 --json
gmc games benchmark --source steam --tags <tag_slug[,tag_slug...]> --reviews-min 1000 --preset summary --json
gmc reviews patterns --source steam --tags <tag_slug[,tag_slug...]> --sample-size 15 --preset summary --json
gmc showcases patterns --source steam --tags <tag_slug[,tag_slug...]> --json

Preserve meta.requestId, meta.entitlements, warnings, and pagination when using output in agent answers.

Supported Beta Commands

• gmc status
• gmc auth status
• gmc schema
• gmc tags
• gmc games search
• gmc games count
• gmc games aggregate
• gmc games resolve
• gmc games detail
• gmc games analysis
• gmc games success-report
• gmc campaigns signals
• gmc games topics
• gmc games language-topics
• gmc games review-history
• gmc games more-like-this
• gmc games compare
• gmc games benchmark
• gmc reviews patterns
• gmc showcases search
• gmc showcases fit

Other cohort, marketing, creator, pricing, and showcase-pattern commands are available as provisional evidence packs. Their names and output fields may still change before the closed-beta contract is frozen.

Updates

gmc update --json reports the current CLI version and the package-manager commands to use after closed-beta npm distribution is available. It does not mutate the local install yet.

Beta Smoke

Run the beta smoke script with a production-like API and beta credential:

GMC_API_BASE_URL=https://gamemarketcopilot.com \
GMC_API_KEY=<display-once workspace API key> \
npm run gmc:smoke:beta

The script validates the JSON envelope for status, schema, title resolution, detail, benchmark, and Showcase fit commands. It prints a redacted summary with request IDs, warning counts, pagination presence, and entitlement metadata presence. Non-JSON responses include HTTP status, content type, and request path so Cloudflare Access interstitials can be diagnosed without printing HTML.