Your AI agent maintains its own context files — a Claude Code plugin with an AGENTS-first model that covers Codex, Copilot, Cursor, Gemini, and 3 more tools.
Give your AI one canonical `AGENTS.md` plus thin bridge files for every major AI coding tool — `CLAUDE.md`, `.cursor/rules/agents.mdc` (modern Cursor), `.clinerules/agents.md` (modern Cline directory mode), `.windsurfrules`, `GEMINI.md`, and an optional `.github/copilot-instructions.md` (Copilot loads AGENTS.md natively) — from a single codebase scan. Signal Gate filtering strips out what agents already discover on their own. Context Guard hooks enforce freshness. Health scoring catches drift before it costs you tokens. 100% Markdown, zero runtime dependencies.
Get Started · Features · How It Compares · Commands · Other AI Tools · Contributing
⚡ Get Started
Get your first AI context files generated in under 60 seconds.
Prerequisites
Using a different AI tool? ContextDocs generates plain Markdown files that work with Codex CLI, GitHub Copilot, Cursor, Windsurf, Cline, and Gemini CLI automatically.
Install
# 1. Add the LBA plugin marketplace (once)
/plugin marketplace add littlebearapps/lba-plugins
# 2. Install ContextDocs
/plugin install contextdocs@lba-plugins
# 3. Bootstrap AI context for your project
/contextdocs:ai-context init
Optional — install Context Guard hooks (Claude Code only):
# 4. Keep context files in sync as your project evolves
/contextdocs:context-guard install # Tier 1 (Nudge) — reminds at session end
/contextdocs:context-guard install --tier enforce # Tier 2 (Enforce) — also blocks commits
Optional — public-facing documentation:
For README, CHANGELOG, ROADMAP, user guides, and launch artifacts, install PitchDocs separately. Both plugins work independently and complement each other.
🚀 What ContextDocs Does
Your AI coding assistant works better when it understands your project's conventions — but overstuffed context files actually make things worse. Research shows bloated context reduces AI task success by ~3% and increases token costs by 20% (ETH Zurich, 2026). Most teams either write too much, write the wrong things, or let context files go stale within a week.
ContextDocs solves the full lifecycle. It scans your codebase, generates AGENTS.md as the canonical shared context, then creates thin bridge files that cover 8 AI tools using the Signal Gate principle — only what agents cannot discover by reading source code on their own. No directory listings, no file trees, no architecture overviews that agents find themselves. Just the conventions, gotchas, and decisions that actually help.
For Claude Code users: Claude Code auto-loads CLAUDE.md every session. The generated CLAUDE.md starts with @AGENTS.md, which imports the canonical shared context directly — so you get the full conventions plus Claude-specific additions without duplication. Other tools (Codex CLI, Gemini CLI, Copilot, Cursor) load their own bridge files or AGENTS.md directly.
Then it keeps them fresh: update patches drift incrementally, promote moves Claude's auto-learned MEMORY.md patterns into CLAUDE.md, context-verify scores health 0–100 across 6 dimensions with 13 checks, and Context Guard hooks enforce freshness at session start, session end, and commit time — with the context-updater agent applying fixes automatically.
🎯 Features
