Question 1

What is AI Context Docs?

Accepted Answer

AI Context Docs is a VS Code extension that creates and maintains a .context/ folder in your project. This folder contains module files that describe what each part of your codebase does, which files belong to it, and when it was last updated — giving any AI assistant instant orientation.

Question 2

How does it work with AI assistants?

Accepted Answer

The .context/ folder contains structured markdown files with JSON frontmatter. AI assistants like Claude Code, Cursor, Copilot, and Windsurf can read these files to understand your project structure, then update them as they make changes.

Question 3

What does the .context/ folder contain?

Accepted Answer

An _overview.md file with the project summary and module index, a _config.json with scan settings and category mappings, and individual module files organised by category. Each module file has JSON frontmatter listing tracked files and a markdown body for architecture notes.

Question 4

How does staleness tracking work?

Accepted Answer

The extension watches your source files for changes. When a tracked file is modified after its module was last updated, that module is flagged as stale in the sidebar.

Question 5

Which editors are supported?

Accepted Answer

AI Context Docs is available on the VS Code Marketplace and Open VSX Registry, and works in VS Code, Cursor, Windsurf, and any editor that supports VS Code extensions.

Question 6

Is it free?

Accepted Answer

Yes. AI Context Docs is free and open source under the MIT license with Commons Clause.

AI Context Docs

Frequently asked questions