gempod

Install and rate Agent skills from the GemPod community, right from your terminal.

What it does

gempod is the registry CLI for GemPod, a community for Agent skills (rules, prompts, and tools that drop into Claude Code, Codex, and other coding agents). With it you can:

• Search the registry for skills the community has found helpful.
• Install any skill, pinned to an exact GitHub commit, into one or more agents on your machine.
• Vote to tell the community whether a skill worked for you.

Search and install work anonymously. Voting requires a free GemPod account.

Install

Requires Node.js 20 or newer.

npm install -g gempod

Or run any command on demand without a global install:

npx gempod <command>

Quick start

gempod search code review --min-upvotes 5
gempod install <gemId>
gempod vote <gemId> --good

<gemId> is the kebab-case identifier shown next to every result, e.g. claude-code-review.

Commands

gempod search <query>...

Search the registry. Results are colorized in the terminal and include the gemId, owner, description, install count, net upvotes, and watcher count.

gempod search web scraping
gempod search git --sort=helpful --min-upvotes 5
gempod search code review --limit 5 --json

| Flag | Description | | --- | --- | | --sort=created\|updated\|helpful\|watched | Result ordering (default updated) | | --limit N | Page size | | --offset N | Pagination offset | | --min-upvotes N | Filter by minimum net upvotes | | --min-watches N | Filter by minimum watcher count | | --only-positive | Only show skills with net-positive votes | | --json | Emit the raw API envelope as JSON (for shell pipes) |

Set NO_COLOR=1 to suppress ANSI styling.

gempod install <gemId>[@<sha>] [options]

Fetch a skill at its registry-pinned GitHub commit and add it to your agents. Under the hood this delegates to npx skills add, which handles writing the files into each agent's skills directory.

Running gempod install <gemId> again upgrades to the latest registry SHA — there is no separate update command. Pin to a specific commit with gempod install <gemId>@<sha> when you need stability.

gempod install <gemId>                            # interactive agent picker
gempod install <gemId> --all                      # all installed agents, no prompts
gempod install <gemId> -y -g --agent claude-code  # scripted, global, Claude Code only
gempod install <gemId>@a1b2c3d                    # pin to a specific commit

| Flag | Description | | --- | --- | | -a, --agent <names> | Comma-separated agent names (e.g. claude-code,codex) or * for all | | --all | Shorthand for --agent=* -y | | -y, --yes | Skip interactive prompts | | -g, --global | Install to ~/.agents/skills instead of the current project | | --copy | Copy files instead of symlinking |

Without --agent, the CLI opens a searchable multi-select picker (arrow keys, space to toggle, Ctrl+A select all, Enter to confirm).

gempod vote <gemId> [--good|--bad|--withdraw]

Tell the community whether a skill was helpful. You need to be signed in, and the skill must be installed locally (--withdraw is exempt).

gempod vote <gemId>             # interactive prompt
gempod vote <gemId> --good
gempod vote <gemId> --bad
gempod vote <gemId> --withdraw  # remove your vote

gempod login / gempod logout / gempod whoami

Sign in via device flow:

1. Run gempod login.
2. Your browser opens to a confirmation page.
3. Paste the 8-digit code shown in the browser back into the terminal.

The token is saved to ~/.gempod/auth.json (mode 0600). gempod logout revokes it on the server and deletes the local file. gempod whoami prints the signed-in account.

For non-interactive use (CI, scripts), set GEMPOD_API_KEY=<token> to bypass the device flow.

Manage installed skills

gempod handles the registry (search, install, voting); the skills CLI handles your local agent directories. After installing, use:

npx skills list             # show installed skills
npx skills remove <name>    # uninstall a skill
npx skills --help           # full reference

This split keeps gempod focused on the registry and SHA pinning, while skills owns the per-agent file layout.

gempod telemetry [status|enable|disable]

Show or change the anonymous usage telemetry setting (see Privacy).

Environment variables

| Variable | Purpose | | --- | --- | | GEMPOD_API | Override the API base URL (default https://gempod.ai) | | GEMPOD_API_KEY | Bearer token for non-interactive auth | | DO_NOT_TRACK | Set to 1 to disable telemetry | | NO_COLOR | Set to any value to disable ANSI colors |

Privacy

Telemetry is anonymous: a random UUID generated on first use, never linked to your account or IP. It fires only on successful installs and records the gem, target agents, and CLI/OS versions. File contents, prompts, credentials, and IP addresses are never collected. Opt out with DO_NOT_TRACK=1 or gempod telemetry disable.

Links

• Website: gempod.ai
• License: MIT