Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nogic.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
Requirements

  • VS Code 1.88.0 or higher (or VSCodium / Code OSS at the same engine version)
  • A workspace folder open in VS Code
That’s it. There’s no separate runtime or service to install. Indexing, parsing, and the MCP server all run inside the extension host.

​
Install from the Marketplace

Nogic is published on both the VS Code Marketplace (used by VS Code) and Open VSX (used by Cursor, VSCodium, Windsurf, Theia, Eclipse Che, and other forks). Use whichever your editor reads from — the build is identical.

​
VS Code Marketplace

  1. Open VS Code
  2. Open Extensions (Cmd+Shift+X / Ctrl+Shift+X)
  3. Search for Nogic (publisher: Nogic)
  4. Click Install
Or from the terminal: 
code --install-extension Nogic.nogic
Direct link: marketplace.visualstudio.com/items?itemName=Nogic.nogic

​
Open VSX (Cursor, VSCodium, Windsurf, etc.)

VS Code forks ship without access to Microsoft’s Marketplace and use Open VSX instead. The install steps are the same — open Extensions, search Nogic, click Install — your editor will pull from Open VSX automatically. CLI equivalents per editor: 
cursor --install-extension Nogic.nogic       # Cursor
codium --install-extension Nogic.nogic       # VSCodium
windsurf --install-extension Nogic.nogic     # Windsurf
Direct link: open-vsx.org/extension/Nogic/nogic

​
Install from a .vsix

If you’d rather sideload a build (or you’re on a Code fork that doesn’t list the extension in its marketplace): 
code --install-extension nogic-<version>.vsix
In VS Code: Extensions sidebar → … menu → Install from VSIX…

​
Verify

After install, run Nogic: Open Visualizer from the Command Palette (Cmd+Shift+P / Ctrl+Shift+P). The visualizer panel should open and offer to index the current workspace.

​
Update

VS Code auto-updates extensions by default. To force an update: Extensions sidebar → find Nogic → click the gear icon → Check for Updates.

​
Where Nogic stores data

PathContents
~/.nogic/workspaces/<hash>/nogic.dbThe local SQLite index for each workspace
~/.nogic/workspaces/<hash>/saved_walkthroughs/Saved AI canvas walkthroughs
~/.codex/config.tomlAn auto-managed [mcp_servers.nogic] block (only if Codex is enabled)
Nothing is sent off your machine. To wipe Nogic’s data, delete the ~/.nogic directory (and the marker block from ~/.codex/config.toml if you’d previously enabled Codex).

​
Uninstall

Extensions sidebar → Nogic → gear icon → Uninstall. To remove all local data: 
rm -rf ~/.nogic

​
Next steps

Quick Start

Open the visualizer and explore your code

MCP Setup

Connect Claude Code or Codex to the canvas