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/guohao1020/docs-cockpit/rendergit clone --depth 1 https://github.com/Guohao1020/docs-cockpitWhat 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.00024 | $0.00563 |
| Opus 5 | $0.00012 | $0.00282 |
| Sonnet 5 | $0.00005 | $0.00113 |
| Haiku 4.5 | $0.00002 | $0.00056 |
Grade A, and why
render 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 3d 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 — 41 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Explicit invocation of the docs-cockpit render pipeline. Use this when the user wants to force a render immediately without going through natural-language workflow detection.
Note:
docs-cockpit build(the pre-1.0 name) was removed in 1.1 — userender.
Steps
-
Locate the config. Look for
docs-cockpit.yamlin the current working directory. If a path argument was passed after the slash command (/docs-cockpit:render configs/preview.yaml), use that path instead. -
Bootstrap if missing. If no config exists, don't fail — hand off to the
docs-cockpit-buildskill's bootstrap workflow (it'll diagnose the doc layout and write a starter config first). -
Run the render.
docs-cockpit render -c <config-path> # Add --debug if the user explicitly asked to debug -
Surface key output lines:
[OK] Built <path>— confirm the HTML wrotestate: <path>— confirm state.json wrote (≥0.1.1 required)[WARN] frontmatter: ...— frontmatter validation warnings[!] docs-cockpit X.Y.Z available— version banner; if seen, suggest invoking/docs-cockpit:update
-
Report counts. Pull the
modules: N | concepts: N | system_docs: Nline and surface it. Also surface themodule status · done=X in-progress=Y ...line and theoverall progress: N%line so the user can see at-a-glance summary. -
Suggest next move based on output:
- All clean → "open
docs/index.htmlto verify" - Frontmatter warnings → suggest consulting
references/schema.mdfor the offending field - Version banner → suggest
/docs-cockpit:update - 0 items (no modules / concepts / system_docs visible) → diagnose
paths.repoand scan paths (usually the cause), suggest--debugrerun
- All clean → "open
Don't do these
- Don't rewrite the user's yaml without permission. If
docs-cockpit.yamlhas problems, point them at the right group / field to edit, don't silently fix. - Don't open the HTML in a browser automatically (some users are in remote / headless environments).
- Don't pass
--no-version-checkunless the user explicitly asks — the version banner is a feature.
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.
- 3d ago First seen · 41 lines · 24 tokens per session scan A a8f566205052
render is a command published in the GitHub repository Guohao1020/docs-cockpit (2 stars, last pushed 2mo ago), licensed MIT. It adds 24 tokens to every session and 563 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
export
Export dashboards to external formats. Currently supports Google Slides.
export
Export the case study — PDF if a browser is installed, HTML either way.
release
Bump version, tag, push, and create a GitHub release with auto-generated notes.
autobot-stop
Stop an autobot session (kill tmux and dev environment, but keep the worktree).
autobot-result
Print the most recent result.md for an autobot session, so the user can see how a bot is doing without attaching to its tmux session.
compile_paper
Convert a SWARM paper from markdown to LaTeX (if needed), compile to PDF, and open it.