flutter dart desktop linux mcp visualization 

Heides Lens

The screen for HEIDES. A desktop viewer and query tool over the HEIDES code nervous system.

Version

v1.0.0

License

MIT

Platforms

Linux, Windows, macOS, Web, Android, iOS

Interfaces

CLI, MCP

View on GitHubMCP server

Overview

Heides Lens is the screen for HEIDES, the deterministic code nervous system that maps every file, symbol, and call into a persistent graph. The engine gives LLMs that map over MCP; the lens gives you the same map to look at. Open a folder, see the mesh, query who calls what, and review real findings before any agent touches anything.

It is a read only viewer and query tool. It does not edit code and it does not run an LLM of its own. It renders the truth that the HEIDES graph already computed.

What you get

  • The neural mesh. A layered dependency layout of the codebase with aligned columns, orthogonal edges, and color coded flows for dependencies, cycles, and back edges.
  • Query. Ask the graph direct questions. Who calls this? What does this file import? Where is this symbol defined?
  • Review. Real findings with evidence, not guesses. Dead code, unused imports, taint, breaking changes.
  • The HEIDES engine built in. One click installs the engine locally on first launch. No account, no cloud.

Download

Installable packages for Linux desktop, version 1.0.0.

Windows, macOS, Android, iOS, and Web packages are on the release roadmap.

Setup

AppImage

chmod +x Heides_Lens-1.0.0-x86_64.AppImage
./Heides_Lens-1.0.0-x86_64.AppImage

Debian package

sudo apt install ./heides-lens_1.0.0_amd64.deb
heides-lens

First launch

  1. The HEIDES engine installs itself with one click. If it is already installed, this step is skipped.
  2. Open a folder.
  3. The neural mesh renders from the spine graph immediately.

Usage

  • Explore the mesh. Drag to pan, scroll to zoom, double click to focus a node.
  • Filter by node type, search symbols, toggle the grid view.
  • Ask the graph anything in plain language and read the answer with locations.
  • Open Review to see what Harmony found, with evidence.

Requirements

  • Linux desktop, version 1.0.0 ships for x86 64.
  • HEIDES 0.14 or newer on the PATH for the engine connection.
  • 2 GB of RAM is comfortable for most workspaces.

Gains

  • The same graph your agents work against, made visible to a human.
  • No more guessing who calls what. The mesh shows it.
  • Real findings with evidence instead of linter noise.
  • Fully local. The graph never leaves the machine.

Repository