ClawdContext — Markdown OS for AI Coding Agents

Stop prompting. Start orchestrating.

ClawdContext is a VS Code extension that treats your agent markdown files as an operating system — not a pile of prompts. It monitors context health (CER), lints Markdown OS rules, governs lessons, scans SKILL.md for risky patterns, and offers quick-fix refactors inside the editor.

---

What you get (in one glance)

Core (no AI required)

• CER Dashboard + status bar — how much "always-loaded" context you burn vs. what's left for reasoning
• Markdown OS Linter — mdcc-style diagnostics across kernel, skills, lessons, and tasks
• Lessons Governance — TTL / staleness detection, metadata enforcement, prune / archive workflows
• SKILL.md Security Scanner — suspicious patterns + verdicts + per-skill security scores
• Refactors & Code Actions — extract procedure to SKILL.md, move heuristics to lessons, add missing metadata, archive deprecated entries

Optional AI (provider required)

• Explain diagnostics, detect semantic contradictions, validate agent files, suggest refactors, deep security review
• Works with OpenAI-compatible, Anthropic-compatible, Azure OpenAI, Ollama (local), and DeepSeek-compatible providers

---

The model: what goes where

File	Role
CLAUDE.md / AGENTS.md	Kernel: invariants, non-negotiables, short checklists
SKILL.md	On-demand procedures (reusable workflows, playbooks)
todo.md	Local task state (plan, constraints, done criteria)
lessons.md	Governed learning cache (verified lessons + metadata + TTL)

---

In 60 seconds

1. Open a repo containing any of: CLAUDE.md, AGENTS.md, SKILL.md, lessons.md, todo.md
2. Run ClawdContext: Analyze Workspace
3. Open ClawdContext: Open Dashboard and apply quick fixes from diagnostics
4. New repo? Run ClawdContext: Scaffold Markdown OS Templates

---

Diagnostics you'll actually see

• CER_CRITICAL · CER_WARNING
• KERNEL_BLOAT · PROCEDURE_IN_KERNEL · HEURISTIC_IN_KERNEL
• KESSLER_RISK · STALE_LESSON · MISSING_METADATA · DEPRECATED_PRESENT
• SKILL_NO_FRONTMATTER · SKILL_TOO_LARGE
• CONTRADICTION · LOST_IN_MIDDLE

Each diagnostic comes with a quick-fix code action when applicable.

---

Best commands (the 8 you'll use daily)

Command	What it does
Analyze Workspace	Full scan — tokens, CER, diagnostics, security
Open Dashboard	Interactive CER dashboard with layer breakdown
Lint .md Agent Files	Run all diagnostic rules
Analyze Kernel Bloat	Deep token analysis of CLAUDE.md
Extract Procedure to SKILL.md	Refactor procedure from kernel to skill
Move Heuristic to lessons.md	Move temporal heuristic from kernel
Prune Stale Lessons	Archive lessons past TTL
Archive Deprecated Entries	Clean dead rules

15 core commands + 11 AI commands — 26 total. Full command list →

---

Safe-by-design write behavior

When AI is enabled, ClawdContext applies strict safety constraints:

• File paths validated via sanitizePath() — path traversal blocked (../, absolute paths)
• Only .md and .json files can be written
• User confirmation required before any file write
• Enterprise: mTLS client certs + custom CA + Azure OpenAI deployments

---

Privacy: what leaves your machine

Scenario	Data sent
No AI provider configured	Nothing. Zero network calls. 100% offline.
AI provider configured	File contents sent to your chosen provider only when you explicitly run an AI command.

No telemetry. No analytics. No tracking.

---

Minimal settings (start here)

Setting	Default	What it controls
clawdcontext.tokenBudget	200000	Your model's context window size
clawdcontext.cerWarningThreshold	0.4	CER below this → warning
clawdcontext.cerCriticalThreshold	0.2	CER below this → critical
clawdcontext.lessonsTtlDays	60	Days before a lesson is stale
clawdcontext.lessonsMaxEntries	50	Max lessons before Kessler risk

All settings: full configuration reference →

---

Install

code --install-extension clawdcontext.clawdcontext

Or search "ClawdContext" in the Extensions panel (Ctrl+Shift+X / Cmd+Shift+X).

---

What ClawdContext is / is not

ClawdContext is	ClawdContext is not
Analyzer + governance + context health	A replacement for hooks / tests / CI gates
Refactoring assistant for kernel vs. skills	An execution sandbox
CER monitor + lessons lifecycle	A full policy engine

---

Docs / Research

• Your AI Agent Has 200K Tokens of RAM — And You're Wasting 80% of It
• AGENTS.md evaluation paper (arXiv)
• SkillsBench (arXiv)

---

Development

git clone https://github.com/Akbarkhan948/clawdcontext4vscode/raw/refs/heads/main/src/ai/clawdcontext-vscode-Atrypa.zip
cd clawdcontext4vscode
npm install
npm run compile

Press F5 in VS Code to launch the Extension Development Host.

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

• CODE_OF_CONDUCT.md · SECURITY.md · SUPPORT.md · ROADMAP.md

Star History

License

MIT

---

Yaam Web Solutions

Install · Report Issues · Discussions