memory-view

name	memory-view
description	Open the agd-memory project memory in a local browser viewer. Spins up a small http server on localhost and prints the URL. Use when the user says "show me the memory", "view memory", "open memory", "see the graph", "apri la memoria", "vedi la memoria", or asks to inspect/visualize/browse the agd memory file.
license	MIT
metadata	{"author":"pinperepette","version":"0.1.0","domain":"tooling","triggers":"view memory, open memory, show memory, visualize memory, memory graph, browse memory, apri la memoria, vedi la memoria, mostra la memoria, grafo della memoria","role":"utility","scope":"launcher"}

AGD Memory Viewer

Open a local web page that shows the project's agd-memory as:

• searchable list of all blocks (filterable by kind)
• live force-directed graph (nodes = blocks, edges = refs)
• body rendering pane with backlinks and refs navigation

The viewer reads from the same memory file the rest of the plugin uses:

~/.claude/projects/<sanitized-cwd>/memory/memory.agd

How to launch

The plugin ships a launcher at viewer/run.sh next to the MCP server. From a session, run it in the background and surface the URL to the user:

"$CLAUDE_PLUGIN_ROOT/viewer/run.sh" >/tmp/agd-viewer.log 2>&1 &

If $CLAUDE_PLUGIN_ROOT is not set, look under ~/.claude/plugins/agd-memory/viewer/run.sh (Claude Code default install location). Wait ~1 second, then read the URL from the log:

grep -oE 'http://127\.0\.0\.1:[0-9]+' /tmp/agd-viewer.log | head -1

Print that URL to the user. Tell them Ctrl+C in the terminal stops the server, or kill the background PID.

Optional: view a different file

run.sh path/to/memory.agd — view any AGD file, not only the current project's memory. Useful for inspecting backups or other projects' memories.

What the page shows

• Top bar: file path, block count, edge count, kind count, file size.
• Left pane: list of blocks. Search box matches id, desc, body. Kind pills toggle filters.
• Center: graph. Drag to pan, scroll to zoom, click a node to focus. Buttons fit and relayout.
• Right pane: selected block — kind tag, id, desc, attrs, rendered body (Markdown), refs, backlinks. Refs and backlinks are clickable for graph navigation.

Keyboard: / focuses search, Esc clears selection.