ShadowRepo

Browse the why behind your codebase. A sidebar tree view of features, specs, and source anchors generated by ShadowRepo — a Claude Code plugin that builds a semantic knowledge graph from your repo.

Not a linter. Not a search box. A structured map of what your code does and why, kept in sync with your repo by an AI agent.

What you get

• ShadowRepo activity-bar view — top-level features, sub-features, specs, and source anchors in one collapsible tree.
• Click an anchor → jump to the file at the right line.
• Auto-refresh — when ShadowRepo (running in Claude Code) updates .shadowrepo/*.json, the tree refreshes automatically.
• Spec dossier webviews — open a feature or spec to see its full markdown, related specs, and source links in a rich panel.
• CodeLens (new in 0.2) — every anchored source file gets a N specs cover this file lens at the top. Anchored functions and classes also get a per-symbol lens that opens the highest-confidence spec.
• Hover (new in 0.2) — hover an anchored symbol to see up to two spec cards (id, type, confidence, summary, "Open dossier" link). When more specs match, a +N more in palette link opens the picker.
• Command Palette ShadowRepo: Find Spec… (new in 0.2) — fuzzy-search every spec by id, feature, type, or summary. Also wired to a 🔍 button at the top of the sidebar.

Quick start

1. Install this extension.
2. In your project, install the ShadowRepo Claude Code plugin and run /shadowrepo-build to generate .shadowrepo/.
3. Open the workspace in VS Code → click the ShadowRepo icon in the activity bar.

No .shadowrepo/ yet? Set shadowrepo.fixturePath to any directory containing a .shadowrepo/ to preview the UI against a fixture.

Settings

Commands

Requirements

• VS Code ^1.90.0
• A .shadowrepo/ directory in your workspace (generated by the ShadowRepo Claude plugin)

Links

• Source & issues: github.com/waynewangyuxuan/shadowrepo-extension-package
• Claude Code plugin: packages/claude-plugin/ in the same repo
• License: MIT