Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add commands/mgd34msu/goodvibes-plugin/analyticsgit clone --depth 1 https://github.com/mgd34msu/goodvibes-pluginWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00022 | $0.00876 |
| Opus 5 | $0.00011 | $0.00438 |
| Sonnet 5 | $0.00004 | $0.00175 |
| Haiku 4.5 | $0.00002 | $0.00088 |
Grade A, and why
analytics scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 44 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Analytics
goodvibes analytics: token usage, cost, cache performance, and agent activity, computed from transcript actuals, never tool self-estimates.
Parse the subcommand from $ARGUMENTS (empty = session summary) and make the matching call. If
the mcp__analytics__* tools are unavailable, say the goodvibes plugin's analytics server is
not running and stop.
| Subcommand | Call | Notes |
|---|---|---|
| (none) | query { "scope": "all", "data_scope": "current_session" } |
Present tokens, cache, cost, and agent activity as a readable summary. If empty: "No analytics data yet. Start working and check back after a few tool calls." |
status |
the same query plus "format": "verbose" |
Verbose session breakdown. |
report |
dashboard { "action": "report" } |
Writes a self-contained HTML report to <project>/.goodvibes/reports/analytics-report.html and returns the path plus a 3-line stats summary. Send that file to the user with SendUserFile (display: "render"), then relay the summary. Optional scope: session, project, all_projects (default when omitted). |
doctor |
dashboard { "action": "doctor" } |
Host health + orphaned-process report. Relay any cleanup commands; never run them unasked. |
budget <amount> |
budget { "action": "set", "amount": <n>, "unit": "dollars", "warn_at": [0.5, 0.8, 1.0] } |
<amount> must parse as a positive number; otherwise ask for one. |
budget |
budget { "action": "check" } |
Report amount set, used, remaining, percent consumed. |
budget clear |
budget { "action": "clear" } |
|
export [format] |
export { "format": "<format>", "scope": "current" } |
format: json | csv | markdown (default). Optional: scope (current, historical, all_projects, session:<id>), sections, output_path, tags. |
tag add <name> / tag remove <name> |
tag with action + value: "<name>" |
A name is required; ask if missing. |
tag list / tag auto |
tag with the matching action |
list accepts scope: "all" to cover every session in the global DB. |
sync / sync all |
sync { "scope": "current" } or { "scope": "all" } |
Incremental (byte-offset tracked). Report files synced, records imported, errors. |
config [key] [val] |
config |
No key: { "action": "get" }. Key only: add "key". Key + value: { "action": "set", "key", "value" }, coercing the value's natural type (number / boolean / string). { "action": "reload" } re-reads config from disk. |
For an unknown subcommand, list the ones above.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 44 lines · 22 tokens per session scan A 7eccb95c48bf
analytics is a command published in the GitHub repository mgd34msu/goodvibes-plugin (6 stars, last pushed 9d ago), licensed MIT. It adds 22 tokens to every session and 876 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other commands, from other repositories
git
Git operations with intelligent commit messages and workflow optimization.
checklist
Generate a custom checklist for the current feature based on user requirements.
clarify
Identify underspecified areas in the current feature spec by asking up to 5 highly targeted clarification questions and encoding answers back into the spec.
specify
Create or update the feature specification from a natural language feature description.
analyze
Perform a non-destructive cross-artifact consistency and quality analysis across spec.md, plan.md, and tasks.md after task generation.
constitution
Create or update the project constitution from interactive or provided principle inputs.