GhostMap shows a fast, language-aware tree of the symbols in the file you have open, plus a lightweight @ghost annotation syntax for marking work items, regions, and notes directly in your source.

What GhostMap does

Active-file Ghost Tree: classes, interfaces, structs, enums, methods, functions, constructors, and @ghost anchors, each with a precise icon.
@ghost annotations: inline comments such as // @ghost #fix-this status:in-progress description: needs retry become navigable tree items, hovers, and diagnostics.
Built for large files: stays responsive on files up to about 60,000 lines without flooding the language server.
Reopens paint in milliseconds: the last known tree per workspace is preserved as a saved Ghost Tree.
Click any tree item to jump to its exact line; use Search to filter.

Supported languages

TypeScript, TSX, JavaScript, JSX, C#, Java, C++, C, Go, Rust, PHP, Python, Ruby, Dart, Scala, Solidity, Julia, Elixir, Groovy, and Objective-C.

Install

From the VS Code Marketplace, search for GhostMap by publisher GhostMap, or run:

ext install GhostMap.ghostmap

Open VSX is planned; it is not published there yet.

Manual install from a downloaded VSIX (fallback/offline use only):

code --install-extension ghostmap-0.5.5.vsix

Quick start

Open a file in any supported language.
Open the GhostMap view in the Activity Bar.
Click any item to jump to it.
Press Ctrl+Alt+G to refresh the current file, or use Search to filter.

@ghost annotations

// @ghost #fix-this status:in-progress description: needs retry logic
function compute() { /* ... */ }

The anchor appears in the tree, the hover shows the description, and an unclosed range surfaces as a diagnostic. Snippets are bundled for JavaScript, TypeScript, JSX, TSX, Python, Java, Go, Rust, PHP, C#, C, C++, Ruby, and Groovy.

Current limits

GhostMap is per-file today; there is no workspace-wide index yet. Known structural gaps include Java arrows on certain multi-method lines, Objective-C nested ranges, Go nesting by receiver, Groovy comment backtracking, and C++ const detection on some signatures. The docs site keeps the live list of known limits.

Documentation and support

Site: https://ghostmap-liard.vercel.app/
Documentation: https://ghostmap-docs.vercel.app/overview
Install and access: https://ghostmap-docs.vercel.app/install
Legal and support: https://ghostmap-docs.vercel.app/legal-support
Contact: [email protected]

License

GhostMap is source-available under the GhostMap Free Non-Commercial License. The packaged extension includes the full LICENSE.txt and THIRD_PARTY_NOTICES.txt files for audit and review.

Free for personal, educational, and evaluation or testing use.
Company, business, production, revenue-generating, client, resale, white-label, marketplace-republish, and competing-product use require written authorization.
Voluntary donations and supporter contributions do not grant commercial-use rights.

Third-party components keep their own upstream licenses; see the bundled LICENSE.txt and THIRD_PARTY_NOTICES.txt files. For commercial licensing or legal questions, contact [email protected].