FlorianBruniaux

FlorianBruniaux / ctxharness

Public

Catch stale versions, broken paths, and missing scripts in your AI instruction files (CLAUDE.md, rules)

ctxharness.bruniaux.com ai claude-code cli context-engineering developer-tools
10
2
100% credibility
Found May 07, 2026 at 10 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

ctxharness detects discrepancies between facts stated in AI instruction files like CLAUDE.md and the actual codebase, ensuring reliable AI-assisted coding.

How It Works

1
🔍 Discover drift issues

You notice your AI helper keeps making mistakes because its instruction notes are outdated, like wrong file paths or old commands.

2
📦 Get the checker

You grab the simple checker tool that spots these mismatches between your notes and your actual project.

3
✨ Scan your notes instantly

With one quick command, it reads your AI notes and instantly flags what's out of sync, like missing files or changed versions.

4
✅ Review the mismatches

It shows exactly where your notes don't match reality, so you know what to update right away.

5
Choose your setup
🔧
Quick fix

Update your notes manually and move on.

🔄
Set up auto-checks

Create a simple plan so it checks automatically on every update.

🎉 AI notes stay perfect

Your AI helper now always has accurate info, working reliably without silent failures.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 10 to 10 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is ctxharness?

ctxharness catches stale versions, broken paths, and missing scripts in your CLAUDE.md or AGENTS.md instruction files, preventing AI agents like Claude Code, Cursor, or Copilot from failing silently on outdated facts. Built in TypeScript, it verifies claims against your codebase—file existence, npm scripts, package versions—via extractors like package.json or nvmrc parsers. Run `npx ctxharness scan CLAUDE.md` for zero-config detection or configure .ctxharness.yml for CI enforcement.

Why is it gaining traction?

Unlike Promptfoo's output evals or general linters, ctxharness targets input drift in AI docs, scanning for vagueness, token bloat, and hook validity alongside facts. The hook is instant scans that flag drifts like renamed scripts or moved paths without setup, plus auto-fix for versions and GitHub Actions integration. Presets for T3, Next.js, Python, Go, Rust speed onboarding.

Who should use this?

Teams with CLAUDE.md files guiding AI agents on architecture, scripts, or paths, especially in Next.js/T3 apps where Prisma models or tRPC routers drift. Backend devs in Python/Go/Rust maintaining AGENTS.md for conventions. Anyone tired of try catch stale element exception in agent sessions from broken instructions.

Verdict

Grab it if you use AI docs—solid docs and CLI make the 1.0% credibility (10 stars) forgivable for this niche. Early stage, but MIT-licensed with CI templates; watch for v1.0 standalone binary. Worth the npx try.

(187 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.