# How to Install Understand Anything on Claude Code, Codex, Cursor, Copilot CLI, and VS Code

> Install Understand Anything seamlessly on Claude Code, Codex, Cursor, Copilot CLI, and VS Code. Discover platform specific installation steps and streamline your workflow effortlessly.

- Repository: [Egonex/Understand-Anything](https://github.com/Egonex-AI/Understand-Anything)
- Tags: how-to-guide
- Published: 2026-06-12

---

**Understand Anything provides a unified [`install.sh`](https://github.com/Egonex-AI/Understand-Anything/blob/main/install.sh) script that adapts to each platform, with Claude Code utilizing a runtime-provided `$CLAUDE_PLUGIN_ROOT` while Codex, Cursor, and Copilot CLI share a symlinked `~/.understand-anything-plugin` directory, and VS Code requiring manual CLI integration.**

The **Egonex-AI/Understand-Anything** repository ships as a **multi-platform plugin** supporting Claude Code, Codex, Cursor, Copilot CLI, and VS Code. While all platforms consume the same monorepo layout (`packages/core`, `packages/dashboard`, `skills/*`), the installation paths, bootstrap commands, and build requirements differ significantly depending on your target environment.

## Claude Code: Runtime Plugin Root Installation

Claude Code installs Understand Anything through native marketplace commands without requiring manual builds. The platform loads skill files directly from the plugin cache using the descriptor at [`.claude-plugin/plugin.json`](https://github.com/Egonex-AI/Understand-Anything/blob/main/.claude-plugin/plugin.json).

Execute these commands in your Claude Code session:

```bash
/plugin marketplace add Egonex-AI/Understand-Anything
/plugin install understand-anything

```

Claude Code places the plugin in `$CLAUDE_PLUGIN_ROOT`, a runtime-provided environment variable. The skill files located in `skills/understand/*.md` are loaded directly from this cache. According to the install snippet in `Install.astro`, this method requires no manual build step because the skill runs inside the active Claude session with existing LLM context.

## Codex, Cursor, and Copilot CLI: Symlinked Architecture

Codex, Cursor, and Copilot CLI share a unified installation pattern using a symlinked directory at `$HOME/.understand-anything-plugin` (mapped to `~/.understand-anything-plugin`). Unlike Claude Code, these platforms require a manual build step after installation, as noted in the warning within [`understand-anything-plugin/skills/understand/SKILL.md`](https://github.com/Egonex-AI/Understand-Anything/blob/main/understand-anything-plugin/skills/understand/SKILL.md) regarding plugin root assumptions.

### Codex Configuration

Codex recognizes the plugin descriptor at [`.codex-plugin/plugin.json`](https://github.com/Egonex-AI/Understand-Anything/blob/main/.codex-plugin/plugin.json). Install using the platform-specific argument to the installer:

```bash
./install.sh codex

```

After installation, you must build the core package:

```bash
pnpm --filter @understand-anything/core build

```

The installer treats Codex as a symlinked install path, creating a reference to the checked-out source. The symlink logic is implemented in `skills/understand/scan-project.mjs`.

### Cursor Setup

Cursor reads its platform-specific descriptor at [`.cursor-plugin/plugin.json`](https://github.com/Egonex-AI/Understand-Anything/blob/main/.cursor-plugin/plugin.json) in the repository root. Install via Cursor's plugin manager:

```bash
cursor plugin install understand-anything

```

Cursor targets the same `~/.understand-anything-plugin` directory shared with Codex and requires the same `pnpm --filter @understand-anything/core build` command.

### Copilot CLI Integration

Copilot utilizes [`.copilot-plugin/plugin.json`](https://github.com/Egonex-AI/Understand-Anything/blob/main/.copilot-plugin/plugin.json) for its plugin manifest. Install through the Copilot CLI:

```bash
copilot plugin install understand-anything

```

Like Cursor and Codex, Copilot symlinks to `~/.understand-anything-plugin` and requires the core build step before use.

## Stand-Alone CLI Installation

For users not using an integrated LLM IDE, the repository provides [`install.sh`](https://github.com/Egonex-AI/Understand-Anything/blob/main/install.sh) as a universal installer. This script supports platform-specific installation, updates, and uninstallation across all supported platforms.

Run the installer directly:

```bash
curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.sh | bash

```

Or execute locally with a specific platform argument:

```bash
./install.sh codex
./install.sh cursor

```

The script creates a symlink at `~/.understand-anything-plugin` pointing to the checked-out plugin source. When detecting a fresh install, [`install.sh`](https://github.com/Egonex-AI/Understand-Anything/blob/main/install.sh) automatically runs `pnpm --filter @understand-anything/core build`. The script supports `--update` for upgrades and `--uninstall <platform>` for platform-specific removal.

## VS Code: Dashboard Integration

Understand Anything does not currently ship a dedicated VS Code extension. Instead, use the CLI to generate the knowledge graph and serve the dashboard externally.

First, complete the CLI installation method above. Then build and serve the React dashboard:

```bash
pnpm --filter @understand-anything/dashboard build
pnpm dev:dashboard

```

Open the resulting dashboard in your browser, or embed it in a VS Code webview. The generated `.understand-anything/` folder contains the knowledge graph data consumed by the dashboard UI in `packages/dashboard`. Future VS Code support is planned; currently, the plugin remains platform-agnostic for any editor capable of launching a browser.

## Summary

- **Claude Code** uses `$CLAUDE_PLUGIN_ROOT` with no build required, loading skills directly from `skills/understand/*.md` via [`.claude-plugin/plugin.json`](https://github.com/Egonex-AI/Understand-Anything/blob/main/.claude-plugin/plugin.json).
- **Codex, Cursor, and Copilot CLI** share `~/.understand-anything-plugin` via symlinks and require `pnpm --filter @understand-anything/core build` after installation.
- **CLI installer** ([`install.sh`](https://github.com/Egonex-AI/Understand-Anything/blob/main/install.sh)) supports all platforms with `--update` and `--uninstall <platform>` flags, automatically building on fresh installs.
- **VS Code** requires manual CLI integration and dashboard building from `packages/dashboard` until a dedicated extension releases.

## Frequently Asked Questions

### Does Understand Anything require building for all platforms?

No. Only Codex, Cursor, Copilot CLI, and the stand-alone CLI require running `pnpm --filter @understand-anything/core build` after installation. Claude Code loads skills dynamically from the plugin cache without manual compilation, as the runtime already provides the LLM context.

### Where does the installer place plugin files on my system?

Claude Code uses the runtime variable `$CLAUDE_PLUGIN_ROOT`. All other platforms (Codex, Cursor, Copilot, and CLI) create a symlinked directory at `~/.understand-anything-plugin` pointing to the source repository, as implemented in [`install.sh`](https://github.com/Egonex-AI/Understand-Anything/blob/main/install.sh) and referenced in `skills/understand/scan-project.mjs`.

### Can I uninstall the plugin for a specific platform only?

Yes. The [`install.sh`](https://github.com/Egonex-AI/Understand-Anything/blob/main/install.sh) script supports platform-specific uninstallation via the `--uninstall <platform>` flag (e.g., `./install.sh --uninstall cursor`). This removes the platform-specific symlinks without affecting other IDE installations.

### Is there a VS Code extension for Understand Anything?

Not currently. The recommended workflow involves installing via CLI, generating the knowledge graph with `/understand --full`, and building the dashboard from `packages/dashboard` to view in a browser or VS Code webview. Native extension support is planned for future releases.