# track-mentions

track-mentions finds fresh web references to the Claude Code Ultimate Guide and updates its tracker. Use it when you need a repeatable mention audit.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 6529 repo stars
- Author: FlorianBruniaux
- License: CC-BY-SA-4.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/FlorianBruniaux/claude-code-ultimate-guide/tree/HEAD/.claude/commands/track-mentions.md
- Updated: 2026-10-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/track-mentions

## What it does

The command searches third-party pages and social posts for references to the Claude Code Ultimate Guide. It reads `docs/media-mentions/mentions.yaml`, compares discovered URLs with the existing set, and ignores the guide’s own site and repository. Results can come from articles, Reddit, X, LinkedIn, videos, podcasts, GitHub, or directories.

The main search uses `mcp__perplexity__perplexity_deep_research`. If that search refuses or returns nothing, the workflow switches to `WebSearch` and checks candidate pages with `WebFetch`. New entries receive a platform category, status, and sequential ID; the command then refreshes the YAML metadata and the stats table in `docs/media-mentions/README.md`.

\`--dry-run` reports findings without editing files. `--add-all` writes every new result automatically; the normal mode asks for confirmation item by item and creates a Git commit. The main workflow requires access to `mcp__perplexity__perplexity_deep_research`.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/track-mentions.md` — Call it with /track-mentions. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/track-mentions.md` — Call it with /prompts:track-mentions. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/track-mentions.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/track-mentions.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/FlorianBruniaux/claude-code-ultimate-guide/tree/HEAD/.claude/commands/track-mentions.md

## When to use it
- discover new guide mentions across the web
- remove URLs already present in the tracker
- classify references by source platform
- refresh the YAML tracker and README stats
- commit the updated media-mention files

## Example prompts
- Run `/track-mentions` and review the new references before adding them.
- Use `/track-mentions --dry-run` to inspect results without changing `docs/media-mentions/mentions.yaml`.
- Run `/track-mentions --add-all` to add every discovered mention.

## Similar
- [perplexity-search](https://affpapa.org/en/nevibecode/skills/dotneet-perplexity-search.md) — skill · 459 installs
- [oracle](https://affpapa.org/en/nevibecode/agents/oracle.md) — subagent · ★ 3951 repo stars
- [track-management](https://affpapa.org/en/nevibecode/skills/track-management.md) — skill · 10300 installs
- [dossier-collect](https://affpapa.org/en/nevibecode/skills/dossier-collect.md) — skill · 702 installs
- [monitoring-instagram-brand-mentions](https://affpapa.org/en/nevibecode/skills/monitoring-instagram-brand-mentions.md) — skill · 938 installs
- [monitoring-brand-mentions-on-twitter](https://affpapa.org/en/nevibecode/skills/monitoring-brand-mentions-on-twitter.md) — skill · 928 installs

From the same set: [florianbruniaux/claude-code-ultimate-guide](https://affpapa.org/en/nevibecode/by/florianbruniaux/claude-code-ultimate-guide.md) — 45 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
