GhostMap

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, and Objective-C.

Install

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

ext install GhostMap.ghostmap

From Open VSX, install from the GhostMap namespace.

Manual install from a downloaded VSIX:

code --install-extension ghostmap-0.5.2.vsix

Quick start

1. Open a file in any supported language.
2. Open the GhostMap view in the Activity Bar.
3. Click any item to jump to it.
4. 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 each supported language.

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 (English start): https://ghostmap-docs.vercel.app/en/overview
• Install and access: https://ghostmap-docs.vercel.app/en/install
• Legal and support: https://ghostmap-docs.vercel.app/en/legal-support
• Contact: getghostmap@proton.me

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 getghostmap@proton.me.