ctx-fix

An interactive command that audits agent context files and proposes fixes for problems such as stale information, broken references, version mismatches, contradictions, and missing entries. It waits for approval before applying each proposed edit.

In plain words
What is it for?
Use it to fix all detected context issues, or limit the audit to named files, tool ecosystems, or issue types.
Why use it?
It reduces the risk of silently changing project instructions while repairing guidance that no longer matches the codebase.

Command

Install

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.

agentmods
npx agentmods add commands/knitli/toolshed/ctx-fix
Clone the repo
git clone --depth 1 https://github.com/knitli/toolshed
Per session 23 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 644 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

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.

ModelPer sessionOnce invoked
Fable 5 $0.00023 $0.00644
Opus 5 $0.00012 $0.00322
Sonnet 5 $0.00005 $0.00129
Haiku 4.5 $0.00002 $0.00064

Measured yesterday against content hash 7c22174eee43, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

ctx-fix 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 yesterday.

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.

plugins/ctx/commands/ctx-fix.md · 61 lines

How it starts

The opening of the file, as written. The whole thing — 61 lines — stays where its author put it; the contents beside it link to each section on GitHub.

/ctx:fix — Auto-Reconcile Context Issues

Fix staleness and drift issues found by /ctx:check and /ctx:drift. Operates interactively: proposes each fix and waits for approval before applying.

Arguments

$ARGUMENTS

  • No arguments: run a full audit, then propose fixes for all issues found.
  • File paths (e.g., /ctx:fix CLAUDE.md): audit and fix issues only in the named files.
  • Ecosystem names (e.g., /ctx:fix serena): audit and fix issues only in files belonging to those ecosystems.
  • Issue types (e.g., /ctx:fix broken, /ctx:fix versions): run a full audit but only propose fixes for the specified issue category (broken, stale, versions, contradictions, gaps, orphaned).

Instructions

First, run a full audit (/ctx) to identify all issues — scoped to the user's arguments if provided. Then work through fixes in priority order.

Fix priority

  1. Broken claims (❌) — References to files, symbols, or commands that don't exist. These actively mislead agents.
  2. Version mismatches — Wrong version numbers are easy to fix and high-impact.
  3. Contradictions between files — Pick the authoritative source and update the others.
  4. Gaps in secondary files — Where Serena/Gemini/Cursor memories are missing information that CLAUDE.md or the constitution has.
  5. Orphaned planning docs — Suggest archival or deletion.

How to fix

For each fixable issue, propose the specific edit:

  • Show the current text (with file path and line number)
  • Show the proposed replacement
  • Explain why this is the correct fix
  • Ask for approval before applying

For version/path/symbol fixes: The codebase is authoritative. Update the context file to match reality.

For contradictions across files: Identify the most authoritative source (usually: constitution > CLAUDE.md > AGENTS.md > tool-specific memories > planning docs). Update less-authoritative files to match.

For orphaned docs: Propose moving to an archive/ directory or deletion. Never delete without explicit approval.

Read the full file on GitHub · 61 lines

Changes

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.

  1. yesterday First seen · 61 lines · 23 tokens per session scan A 7c22174eee43

Subscribe to this mod's changes

ctx-fix is a command published in the GitHub repository knitli/toolshed (1 stars, last pushed 4mo ago), licensed MIT. It adds 23 tokens to every session and 644 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.