Getting it into your agent
It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.
git clone --depth 1 https://github.com/steve-magne/hookstacknpx agentmods add commands/steve-magne/hookstack/okfWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/commands/steve-magne/hookstack/okf)<a href="https://agentmods.dev/commands/steve-magne/hookstack/okf"><img src="https://agentmods.dev/badge/commands/steve-magne/hookstack/okf/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/commands/steve-magne/hookstack/okf"><img src="https://agentmods.dev/badge/commands/steve-magne/hookstack/okf.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What 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.1 | $0.00000 | $0.00699 |
| Opus 5.5 | $0.00000 | $0.00280 |
| Sonnet 5.5 | $0.00000 | $0.00140 |
| Haiku 4.5 | $0.00000 | $0.00070 |
Grade A, and why
okf 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 1mo 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 — 58 lines — stays where its author put it; the contents beside it link to each section on GitHub.
OKF — Connaissance projet (consulter & maintenir)
Bundle de connaissance OKF dans okf/ : source de vérité (architecture, vision, marketing,
roadmap, conventions). Cette commande aiguille vers le bon usage selon $ARGUMENTS.
Optimisation tokens — principe
Ne jamais charger tout le bundle dans le contexte principal. Deux leviers :
- Retrieval déterministe (
node scripts/okf.mjs query ...) — ~0 token modèle. - Délégation au sous-agent
okf-librarian— il lit dans son propre contexte et ne renvoie qu'une synthèse. Préférer ça dès que la réponse demande plus d'un concept.
Routage selon $ARGUMENTS
(vide) ou consult <sujet> — consulter
Déléguer au sous-agent okf-librarian : « Donne le contexte OKF pour : <sujet> ».
Il renvoie réponse + sources + points à vérifier. Pour un besoin trivial mono-concept,
node scripts/okf.mjs query <sujet> puis lire le seul fichier en tête suffit.
enrich — passe d'enrichissement
node scripts/okf.mjs stale— confirmer la péremption.- Déléguer à okf-librarian en mode ENRICHISSEMENT (cf.
okf/meta/self-improvement.md). - Vérifier
node scripts/okf.mjs validate→ OK, et qu'une entrée a été ajoutée àokf/log.md.
check — santé du bundle
node scripts/okf.mjs validate --strict # liens cassés + champs recommandés inclus
node scripts/okf.mjs stale
validate accepte --json (CI/automatisation). Erreurs dures = §9.1/§9.2 ;
warnings = liens cassés (tolérés §5.3), champs recommandés manquants, frontmatter des
fichiers réservés. --strict rend les warnings fatals.
map — catalogue complet compact
node scripts/okf.mjs map
graph — graphe HTML interactif autonome
node scripts/okf.mjs graph # écrit okf/graph.html (versionné dans le repo)
node scripts/okf.mjs graph -o /tmp/okf.html
Régénérer après tout ajout/suppression de concept ou de lien, comme index.
Concepts = nœuds (couleur par type), liens markdown = arêtes ; panneau détail avec
liens sortants / cité par, filtre par type, recherche. Ouvrir le .html dans un navigateur.
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.
- 1mo ago First seen · 58 lines · 0 tokens per session scan A 23665ec36ed4
okf is a command published in the GitHub repository steve-magne/hookstack (7 stars, last pushed 4d ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 699 tokens. 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
handover
Dump the in-head topics of this session, triage each into a bucket (handover / memory / project-docs / do-now), act on them, and write a handover file for the next session to pick up. Say "/handover ok" to run non-interactively with default buckets; any further text is a note to the next session ("/handover ok resume…
context-audit.template
This prompt was authored for Claude-style slash workflows. In Codex runtime, adapt tool calls as follows.
remember
Save the user's input into Tau Git Memory now.
tree
Show the Tau Git Memory tree as a visual schema.
recall
Search Tau Git Memory now for.
status
Run Tau Git Memory status now.