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

Understand Anything provides a unified 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.

Execute these commands in your Claude Code session:

/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 regarding plugin root assumptions.

Codex Configuration

Codex recognizes the plugin descriptor at .codex-plugin/plugin.json. Install using the platform-specific argument to the installer:

./install.sh codex

After installation, you must build the core package:

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 in the repository root. Install via Cursor's plugin manager:

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 for its plugin manifest. Install through the Copilot CLI:

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 as a universal installer. This script supports platform-specific installation, updates, and uninstallation across all supported platforms.

Run the installer directly:

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

Or execute locally with a specific platform argument:

./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 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:

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.
• 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) 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 and referenced in skills/understand/scan-project.mjs.

Can I uninstall the plugin for a specific platform only?

Yes. The 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.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}