Hexana — IntelliJ Plugin Documentation¶
Hexana is an IntelliJ Platform plugin (plugin ID org.jetbrains.hexana, vendor JetBrains) for WebAssembly and binary analysis. It parses .wasm modules, renders WAT and WIT, integrates with WASM runtimes (Wasmtime, WAMR, GraalVM), exposes a Model Context Protocol (MCP) server for AI-assisted exploration, and ships Java-side code completion for the GraalWasm and Chicory APIs. This documentation set describes the 0.9.x line — initial 0.9 release on 2026-05-07 and 0.9.1 patch on 2026-05-20.
What's in this directory¶
| File | Audience | Purpose |
|---|---|---|
getting-started.md |
Users | Install Hexana, open a .wasm file, find the main views. |
features.md |
Users | Complete capability reference grouped by surface. |
file-types.md |
Users | .wasm, .wat, .wit, generic binary (.bin, .elf, .exe). |
wit-language.md |
Users | WIT (WebAssembly Interface Types) language support. |
run-and-debug.md |
Users | Run configurations, runtime selection (Wasmtime / WAMR / GraalVM), experimental debugging. |
mcp-tools.md |
AI-tool users | Hexana's 17 MCP tools, one section per tool. |
java-integration.md |
Java/JVM users | GraalWasm and Chicory completion and inspections. |
js-integration.md |
JS / TS users | WebAssembly.instantiate imports completion and .instance.exports type inference. |
settings.md |
Users | Settings → Tools → Hexana and Settings → Build, Execution → WASM Runtime. |
troubleshooting.md |
Users | Common failure modes and resolutions. |
changelog-0.9.md |
All | Release notes for the 0.9.x line (0.9, 0.9.1), pinned. |
llms.txt |
LLM agents | Curated index for AI assistants reading the docs. |
Version and compatibility¶
- Plugin version: 0.9.1 (built from
release/0.9branch, commit9a615b34; initial 0.9 cut at6a108799). since-build: defined bygradle.properties→defaultSinceBuild. Hexana targets IntelliJ Platform 2024.1+.- Optional integrations: the JavaScript plugin (enables JS interop for
instance.exports) and the Java module (enables GraalWasm / Chicory completion). Both are loaded when the host IDE bundles them. - Required dependency:
com.intellij.mcpServer— Hexana registers its toolset against the platform MCP server.
Supported IDEs¶
IntelliJ IDEA, RustRover, WebStorm, CLion, PyCharm, Rider, PhpStorm, and any other IDE on IntelliJ Platform 2024.1+ that bundles or installs com.intellij.mcpServer. RustRover and CLion users get the natural fit for binary tooling; WebStorm and PhpStorm users get JS interop.
A companion VS Code extension is published separately on marketplace.visualstudio.com and open-vsx.org. See the VS Code section of this site for that product's documentation.
How to read this set¶
- First-time user:
getting-started.md→features.md. - Already opened a
.wasm, want to run it:run-and-debug.md. - Driving Hexana from an AI assistant:
mcp-tools.md. - Plugin doesn't load / file doesn't open:
troubleshooting.md.
Source of truth¶
This documentation set describes the 0.9.x line, currently 0.9.1. For unreleased work, see idea-plugin/CHANGELOG.md in the repository root. For the master-branch state, see commit history after 9a615b34.