Knowledge Copilot

Knowledge Copilot turns your workspace Markdown into a searchable, inspectable wiki inside VS Code.

It helps when useful project knowledge is spread across notes, docs, decisions, and meeting write-ups, but is still hard to query, browse, and keep connected. Instead of treating that content as isolated files, the extension builds a generated wiki under .knowledge/wiki/ and lets you ask questions against it in chat with citations back to the stored pages.

Thanks to Andrej Karpathy's llm-wiki.md.

Why Use It

• Turn scattered Markdown into one navigable knowledge space
• Ask project questions in chat and get cited answers
• Keep generated knowledge readable as normal Markdown files
• Save valuable answers back into the wiki for later reuse
• Navigate wiki pages with wikilink completion, hover, definition, and diagnostics

How It Works

Knowledge Copilot keeps your original Markdown as the source of truth and writes generated knowledge into a separate workspace area:

.knowledge/
  schema/
  wiki/

• .knowledge/wiki/ contains generated wiki pages such as summaries, concepts, answers, and index pages
• .knowledge/schema/ contains per-operation prompt schema files created automatically as needed

Quick Start

1. Open a folder or workspace in VS Code.
2. Make sure GitHub Copilot Chat is available.
3. Add Markdown files to your workspace.
4. Run @knowledge /ingest in chat.
5. Ask questions with @knowledge /query ... or @knowledge ....
6. Save useful answers with the Save answer follow-up action.

By default, the extension scans workspace Markdown files and excludes .knowledge/** plus any patterns configured in knowledgeCopilot.sourceExcludes.

Main Commands

Ingest Markdown

@knowledge /ingest

Scans your Markdown sources and generates a wiki with pages such as:

• index.md for the main catalog
• overview.md for a high-level summary
• sources/*.md for source-based summaries
• concepts/*.md for shared concepts and entities
• answers/*.md for saved query responses

Ask Questions

@knowledge /query What changed in the architecture?
@knowledge What changed in the architecture?

Answers are grounded in the current wiki and include citations to the relevant generated pages.

Lint the Wiki

@knowledge /lint

Checks the generated wiki for issues such as contradictions, orphaned pages, and missing cross-references.

Generated Wiki Experience

Inside .knowledge/wiki/, generated pages behave like normal Markdown and support:

• wikilink completion after typing [[
• Go to Definition for wiki links
• hover previews for linked pages
• diagnostics for broken links

Release Notes

See CHANGELOG.md for version history and release details.

More Information

For implementation details and design docs, see:

• docs/architecture.md
• docs/spec-product.md
• docs/spec-data-contract.md
• docs/spec-acceptance.md