cdeust/cortex-viz/cortex-visualize

Visualize — Interactive Neural Graph (hypermnesia-mcp-viz)

Keywords

visualize, graph, neural graph, memory map, show memories, visual overview, entity graph, methodology graph, codebase graph, session trace, show profile, galaxy

Overview

Launch the interactive browser-based neural graph served by the hypermnesia-mcp-viz MCP. It reads Cortex's shared PostgreSQL store (read-only) plus your ~/.claude session history and wiki, and opens six reading angles over the same data: Trace (default), Graph (the galaxy), Knowledge, Wiki, Board, and Pipeline.

Use this skill when: the user wants a visual overview, is exploring the knowledge/codebase graph, or needs to present or screenshot Cortex's state.

Requires: the hypermnesia-mcp-viz MCP. If its tools are not available, tell the user to install hypermnesia-mcp-viz (https://github.com/cdeust/cortex-viz).

Works without Cortex: hypermnesia-mcp-viz does NOT require the Cortex memory engine to be useful. When Cortex's PostgreSQL is unreachable (or CORTEX_VIZ_NO_DB=1 is set) the server starts in no-DB mode: the Trace view — the per-session execution drill over ~/.claude session logs + git — is fully live, and the five DB-backed views (Graph, Brain, Knowledge, Wiki, Board) appear greyed out with an install pointer instead of erroring. So launch it freely even if the user hasn't installed Cortex.

Workflow

Launch the neural graph

mcp__plugin_hypermnesia-mcp-viz_hypermnesia-mcp-viz__open_visualization({})

Or filter to a specific domain:

mcp__plugin_hypermnesia-mcp-viz_hypermnesia-mcp-viz__open_visualization({ "domain": "cortex" })

Opens in the browser on a local 127.0.0.1 port. Features:

• Trace — the live execution drill: domain → session → ordered

prompt → action → file chain → a file's AST symbols, impact neighbourhood, and git history.

• Graph — the galaxy: every project as a node cloud (setup → tools →

files → discussions → memories → AST symbols), with cross-project shared-code and impact edges.

• Knowledge / Board / Wiki / Pipeline — memory cards, the consolidation

kanban, the browsable wiki, and the domain→stage Sankey.

• Interactive — click any node for a full detail panel, drag to explore,

scroll to zoom; filter by kind / domain / AST edge.

Get graph data (programmatic)

For custom visualization or analysis without opening the browser:

mcp__plugin_hypermnesia-mcp-viz_hypermnesia-mcp-viz__get_methodology_graph({ "domain": "<optional filter>" })