> ## 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.

# Installation

> Install the Nogic editor extension

## 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:

```bash theme={null}
code --install-extension Nogic.nogic
```

Direct link: [marketplace.visualstudio.com/items?itemName=Nogic.nogic](https://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:

```bash theme={null}
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](https://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):

```bash theme={null}
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

| Path                                             | Contents                                                               |
| ------------------------------------------------ | ---------------------------------------------------------------------- |
| `~/.nogic/workspaces/<hash>/nogic.db`            | The local SQLite index for each workspace                              |
| `~/.nogic/workspaces/<hash>/saved_walkthroughs/` | Saved AI canvas walkthroughs                                           |
| `~/.codex/config.toml`                           | An 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:

```bash theme={null}
rm -rf ~/.nogic
```

## Next steps

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Open the visualizer and explore your code
  </Card>

  <Card title="MCP Setup" icon="plug" href="/mcp/overview">
    Connect Claude Code or Codex to the canvas
  </Card>
</CardGroup>