Skip to content
| Marketplace
Sign in
Visual Studio Code>Programming Languages>Bille's Salesforce AI AtlasNew to Visual Studio Code? Get it now.
Bille's Salesforce AI Atlas

Bille's Salesforce AI Atlas

Andreas Bille Madsen

| (0) | Free
100% offline Salesforce AST/Metadata indexer, repo map generator, and agent tools for VS Code.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Bille's Salesforce AI Atlas

A 100% offline, privacy-first Visual Studio Code extension that builds a deterministic AST and metadata index of your Salesforce codebase, delivers pinpoint context for AI agents, and saves 70–90% on LLM tokens with zero IDE lag.

Bille's Salesforce AI Atlas Logo

License: MIT Visual Studio Marketplace 100% Offline Buy Me A Coffee


💡 About This Project

Bille's Salesforce AI Atlas was created by Andreas Bille as a passion project for the Salesforce developer community.

As Salesforce codebases grow to hundreds of Apex classes, complex triggers, Lightning Web Components, and massive custom object metadata files, modern AI assistants (such as GitHub Copilot, Cursor, Claude Code, and Gemini) quickly become overwhelmed by giant context windows. Dumping multi-thousand-line files into prompts causes rate-limit exhaustion, high token costs, and hallucinations.

Bille's Salesforce AI Atlas solves this challenge from the ground up:

  • It analyzes and indexes your entire project 100% offline in an isolated Node.js worker thread.
  • It extracts targeted code context with pinpoint accuracy so AI tools receive only the exact method, class, or metadata snippet required.
  • It optimizes for LLM Prompt Caching by maintaining a strictly deterministic, alphabetical index with zero dynamic timestamps.

⚡ Key Features

1. 🔒 100% Offline & Complete Privacy

  • Zero Network Traffic: Absolutely no code, metadata, or telemetry is sent across the internet.
  • Air-Gapped Friendly: Functions entirely on your local machine with zero external API dependencies.
  • Sensitive File Shield: Built-in path traversal guards strictly block queries into .env, .sfdx, .sf, .git, private keys (.key, .pem), and certificates.

2. ⚡ Off-Thread AST & Metadata Indexer (Zero IDE Lag)

  • Dedicated Worker Thread: All Regex tokenization and AST parsing runs inside a background worker_thread—your editor never freezes or drops frames.
  • SHA-256 Dirty Checking: Files are hashed before parsing; unchanged files are skipped instantly.
  • Intelligent 800 ms Debounce: Batches rapid file saves during active coding sessions before triggering index re-computation.
  • Instant Startup: The in-memory cache hydrates in under 5 ms upon workspace launch.
  • Supported Salesforce Artifacts:
    • Apex Classes (.cls): Classes, interfaces, enums, methods, properties, and @AuraEnabled annotations.
    • Apex Triggers (.trigger): Target objects and trigger events (before insert, after update, etc.).
    • Lightning Web Components (**/lwc/**/*.js): Components, @api reactive properties, and @wire adapters.
    • Salesforce Flows (*.flow-meta.xml, *.flow): Process types, record triggers, action calls, and subflows.
    • Aura Components (**/aura/**/*): Components, applications, attributes, handlers, events, and JS controller functions.
    • Visualforce (**/pages/**/*, **/components/**/*): Pages, components, controllers, extensions, and action expressions.
    • Custom Metadata & Config (*.md-meta.xml, *.labels-meta.xml, *.permissionset-meta.xml, *object-meta.xml): Custom Metadata types/records, Custom Labels, Permission Set object permissions, and Custom Objects & fields.

3. 🧠 Deterministic Prompt-Cache Optimized JSON

  • A-Z Canonical Sorting: Files and symbol keys are sorted deterministically so identical code produces identical JSON output.
  • Zero Timestamps: No dates or volatile metadata are stored in the index, ensuring maximum cache hit rates for AI Prompt Caching.
  • Reverse Lookup Map (symbolMap): Case-insensitive symbol table enabling sub-millisecond symbol lookups.

4. 🎯 Pinpoint Context Extraction & Agent Tools (vscode.lm)

  • Targeted Code Extraction: Automatically isolates requested methods and symbols with a configurable 2-line padding, eliminating thousands of irrelevant lines from the context.
  • Repo Map Generation (sfci.getRepoMap): Generates an ultra-compact, hierarchical Markdown tree of your Salesforce architecture with token budget enforcement.
  • Native VS Code Language Model Integration: Exposes repo map and symbol extraction tools to VS Code AI chat and agent environments via vscode.lm.registerTool.

5. 📊 Live Token Telemetry in Status Bar

  • Real-time Savings Indicator: Displays current index token volume and session savings directly in your status bar:
    $(pulse) SF Index: 18,450 tok | Saved: 76%
    
  • Session Telemetry Engine: Caches baseline file tokens once per unique file and tracks saved tokens as targeted context is delivered.

6. 🗂️ Clean, Unobtrusive UI & QuickMenu

  • No Activity Bar Clutter: Keeps your sidebar clean by operating exclusively through the Status Bar and Command Palette (Ctrl + Shift + P).
  • Interactive QuickMenu (sfci.showQuickMenu): 1-click access to rebuild index, generate repo map, browse symbols, or inspect telemetry.
  • Symbol Browser (sfci.browseSymbols): Fast QuickPick fuzzy finder displaying symbols, file paths, and line ranges with 1-click navigation.

7. ⚙️ Configurable Index Storage

  • Easily customize where the index JSON file is stored via VS Code Settings (sfci.indexPath) or directly in the QuickMenu.
  • Supports both workspace-relative paths (e.g., .vscode/sf-intelligence-index.json, .sfdx/my-index.json) and absolute paths.

🚀 Commands & Shortcuts

Access these anytime via Ctrl + Shift + P (Windows/Linux) or Cmd + Shift + P (macOS):

Command Title Description
sfci.showQuickMenu Open Quick Menu Opens the main action menu with 1-click options.
sfci.browseSymbols Browse Indexed Symbols Search and jump to any indexed class, method, trigger, or field.
sfci.refreshIndex Refresh Index Re-scans the workspace and rebuilds the deterministic index.
sfci.getRepoMap Generate Repo Map Generates a token-optimized Markdown map of your codebase.
sfci.showStatus Show Status & Telemetry Displays indexed files, token stats, and session savings.
sfci.resetTelemetry Reset Token Telemetry Resets session savings counters.
sfci.setIndexPath Configure Index Storage Path Interactively changes the index storage location.

⚙️ Configuration

Configure through the VS Code Settings editor (Ctrl + ,) or in your .vscode/settings.json:

{
  "sfci.indexPath": ".vscode/sf-intelligence-index.json"
}
  • sfci.indexPath: Workspace-relative or absolute file path where the deterministic JSON index is persisted.

☕ Support the Project

If Bille's Salesforce AI Atlas helps you save tokens, speeds up your AI workflow, or makes your daily Salesforce development in VS Code more efficient, please consider buying me a coffee!

Buy Me A Coffee

Every contribution is deeply appreciated and fuels further open-source development. Thank you! 💙


⚠️ Disclaimer

[!CAUTION] Use at your own risk: This extension is an independent, personal spare-time project developed by Andreas Bille for the developer community. It is not an official Salesforce product, nor is it affiliated with, sponsored, certified, or endorsed by Salesforce, Inc.

No Liability: The author assumes no responsibility or liability for how users choose to utilize this extension, AI agent behavior, context generated from source code, or any consequences resulting from its use. Users are solely responsible for testing and reviewing all AI-generated suggestions before applying them to production environments.


📄 License

This project is licensed under the MIT License.

MIT License

Copyright (c) 2026 Andreas Bille

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft