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

# Introduction

> AI-powered code comprehension, inside your editor

## What is Nogic?

Nogic is an editor extension for VS Code, VSCodium, and other Code OSS-compatible IDEs, built around a single goal: **help you understand code faster**.

Press `Cmd+K` anywhere on the canvas and ask a question (*"how does authentication work here?"*, *"walk me through the request lifecycle"*, *"what happens when the token expires?"*). An AI client (Claude Code or Codex) answers by drawing the explanation. Architecture, sequence, dataflow, state machine, and ER diagrams unfold step by step, with a narrative cursor that walks you through each piece. The AI client reads your real code via its own tools, so this works **in any language**.

Nogic also turns your workspace into an interactive map of files, classes, functions, and the connections between them. The map is useful on its own for exploring, but more importantly, it's the substrate for **Diff Analyze**: changes get smart-ordered by dependency, classified, and scored by blast radius so you read the right code in the right order, not an AI summary instead of the code.

## Why Nogic?

Most AI tooling tries to summarize code for you. Summaries replace comprehension; you skim, you trust, you merge, and the codebase grows more opaque to you over time.

Nogic takes the opposite approach: **show the code with superpowers, don't summarize it**.

* AI explains code visually instead of textually: diagrams you can navigate, not paragraphs you skim
* Diff analyze surfaces *which* code deserves attention (risk, blast radius, classification) without writing the review for you
* The visualization makes structure and connections legible so you don't have to keep them in your head

You're still reading the code. Nogic just makes sure you're reading the *right* code, in the *right* order, with the *right* context.

## What you can do

<CardGroup cols={2}>
  <Card title="Ask AI on the canvas" icon="wand-magic-sparkles" href="/features/agent-canvas">
    `Cmd+K` and let the AI render the answer as a walkable diagram
  </Card>

  <Card title="Analyze diffs with AI" icon="clipboard-check" href="/features/diff-analyze">
    Smart-ordered diffs with risk, blast radius, and connection arrows
  </Card>

  <Card title="Explore your codebase" icon="diagram-project" href="/features/visualizer">
    Files, classes, and connections as one navigable graph
  </Card>

  <Card title="Build focused boards" icon="layer-group" href="/features/visualizer#boards">
    Pin the parts of the codebase you reach for repeatedly
  </Card>
</CardGroup>

## Privacy

Your code stays on your machine. Parsing, indexing, visualization, and the MCP server all run locally inside your editor. No code, files, or personal data is sent to external servers.

Prompts you type into `Cmd+K` go to whichever AI CLI you've configured (Claude Code or Codex). Nogic itself doesn't proxy or log them. See [nogic.dev/telemetry](https://nogic.dev/telemetry) for the (anonymous) metrics the extension does collect.

## Language support

| Surface                                                                                   | Languages                                       |
| ----------------------------------------------------------------------------------------- | ----------------------------------------------- |
| **AI canvas** (`Cmd+K` cursor, render / patch / dataflow / sequence / state machine / ER) | **Any language**                                |
| **Code graph** (visualizer, boards, diff analyze, blast-radius, `render_code_tour`)       | JavaScript / TypeScript (incl. JSX/TSX), Python |

The AI canvas works on any codebase because the AI client reads files with its own native `Read` / `Glob` / `Grep`. It doesn't need Nogic's symbol index. Press `Cmd+K` in Rust or Go and you'll still get diagrams.

The graph-backed features (visualizer view, diff analyze scoring, the high-verbosity `render_code_tour`) need parsed symbols, which today means JS / TS / Python. More languages are on the way.

## Next steps

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Install the extension and ask your first question on the canvas
  </Card>

  <Card title="Connect Claude Code" icon="terminal" href="/mcp/claude-code">
    Set up `Cmd+K` with Claude Code
  </Card>
</CardGroup>