Grimoire — Your Codebase, Decoded

AI-powered treemap visualization, inline annotation, and plain-English descriptions for any project.

Grimoire maps your entire codebase into an interactive, zoomable treemap — like Google Maps, but for your repo. Every file gets a description of what it does, color-coded tags based on its imports, and one-click navigation to the source.

Built for vibe coders, non-technical teammates, and anyone who inherits a codebase and thinks "...where do I even start?"

What's New in 0.5.0

• unify scan commands, replace treemap with grid layout, add inline strip option

Features

Interactive Treemap

See your entire project at a glance. Directories are proportionally sized rectangles — bigger directories take up more space. Click to zoom in, breadcrumbs to zoom back out.

AI-Powered Descriptions

Every file and folder gets a 10-25 word description of what it actually does. Powered by Claude. Choose between Plain English (no jargon) or Technical mode.

4 Annotation Modes

Add AI-generated inline comments to any file — or your entire workspace at once:

Comment Management (ᚲ Kenaz System)

Grimoire tags every comment it generates with the ᚲ (Kenaz) rune — the Elder Futhark symbol for "torch" — so it can always tell its comments apart from yours. This enables three powerful strategies:

Configure the default behavior in settings with grim.commentStrategy, or set it to ask to choose each time.

Smart Import Tags

Files are automatically tagged based on their imports — api, auth, database, ai, state, routing, and 80+ more patterns. Tags are color-coded in the treemap.

Sidebar Tree View

Collapsible tree in the VS Code sidebar with smart icons, descriptions, and rich tooltips showing code snippets.

Search

Find files by name, description, tag, or path. Cmd+K / Ctrl+K opens search from anywhere in the map.

Floating Toolbar

Adjust text size (S / M / L) and toggle Plain English mode without leaving the map.

Quick Start

1. Install the extension
2. Open a project in VS Code
3. Cmd+Shift+P → "Grimoire: Scan Workspace" (free, instant, no API key needed)
4. Cmd+Shift+P → "Grimoire: Open Interactive Map" to see your treemap

For AI-powered descriptions, add your Anthropic API key:

• Cmd+Shift+P → "Grimoire: Setup / API Key"
• Or go to Settings → search grim.anthropicApiKey

Commands

Settings

Privacy & Security

• Your API key is stored locally in VS Code settings. It is never sent to any server other than api.anthropic.com.
• Grimoire does not collect telemetry, analytics, or usage data.
• Your code is sent to the Anthropic API only when you explicitly run an AI command (Scan with AI, Annotate). It is never sent automatically.
• The .grimoire.json file stays in your project folder. You can .gitignore it.

Pricing

Free tier: All features work with your own Anthropic API key. You pay Anthropic directly for API usage (typically $0.50-2.00 per project scan).

Grimoire Pro ($5/month, coming soon): No API key needed. Everything just works. Priority support and early access to new features.

Requirements

• VS Code 1.80.0 or later
• For AI features: an Anthropic API key

Feedback & Issues

Found a bug? Have a feature request? Open an issue on the GitHub repository.

Built with Claude by Anthropic.