Skip to main content

context-graph-viewer

A read-only terminal viewer for your Context Graph. It shows what your Claude Code / Codex hooks captured, whether capture is failing, where reconciliation stands, and what the graph learned, without Cypher or Memgraph Lab.

memgraph-context-graph ui

It reads the same config file as the hooks (CONTEXT_GRAPH_CONFIG, else ~/.config/context-graph/config.toml), polls Memgraph every few seconds, and never writes to the graph.

Install

memgraph-context-graph setup installs it unless you pass --no-viewer. It runs in the same tool environment as memgraph-context-graph, so to add it by hand, add it to that tool's uv tool install:

uv tool install "memgraph-context-graph[mcp]" \
  --with "skills-graph[memgraph-context-graph]" \
  --with "actions-graph[memgraph-context-graph]" \
  --with "sessions-graph[memgraph-context-graph]" \
  --with context-graph-viewer

context-graph-viewer also installs its own command, which takes the same flags as memgraph-context-graph ui.

Views

View Reached by Shows
Dashboard start Sessions in scope, the pipeline (reconcile and embedding queues, extraction backend, ontology version, failures, capture tokens), capture health (the local capture-failure log plus hints from the graph), and new entities per day.
Session enter on a session The timeline with subagents folded under the call that spawned them, each action's input and the resources it touched, and what the session produced (chunks, entities, memory files).
Entities k on the dashboard, g on a session Entities merged by name, by support (how many sessions and memory files ground them) or most recent, with their provenance.
Neighbourhood enter on an entity One entity's relations grouped by type, with the evidence behind each. enter on a neighbour moves there; esc walks back.

Keys

Key Does
a Widen the scope: your sessions → plus unattributed ones → everyone's
p Narrow every view to one project (working directory)
/ Filter the table
1–4 Jump to a pane; f makes it fill the screen
v Neighbourhood: relation tree or flat table
+ / - Neighbourhood: raise or lower the confidence floor
h / s Entities: show value types (dates, amounts) / sort by most recent
w Enterprise: next space this login can read
r Refresh now
? All keys
esc / q Back / quit

Look

The viewer opens in Memgraph's brand: black surface, white text, grays for borders, and orange for focus, the selected row, key hints and the timeline bars. Yellow, red and green appear only for warning, error and success. The palette lives in context_graph_viewer/theme.py, and a test keeps views from naming a colour of their own. ctrl+p opens Textual's command palette, where any built-in theme can replace it.

Scope

By default you see your own sessions: identity.user_id in Community, your Memgraph login in Enterprise. Sessions captured before a user was configured belong to nobody (reconcile files them under an anon-… user), so if the dashboard opens empty, press a.

Development

Tests run against a real Memgraph and drive the app headless:

./scripts/dev-memgraph.sh test context-graph-viewer

Metadata

Release files for context-graph-viewer 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for context-graph-viewer 0.1.1
File Size Uploaded Provenance
context_graph_viewer-0.1.1.tar.gz 45.5 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for context-graph-viewer 0.1.1
File Interpreter ABI Platform
context_graph_viewer-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 85.1 kB

Release files / context_graph_viewer-0.1.1.tar.gz

Download URL context_graph_viewer-0.1.1.tar.gz
Size 45.5 kB
Tags Source
SHA-256 checksum
How to use checksums
b95b4447a1398f1281ffa0db055752b085eece2f34988d36a7c7f5cd145f1db6
BLAKE2b-256 checksum
How to use checksums
a20288c977c0cf3b615ba9768d98c85e227c77f7499c6be3cadfe5ed233bd1e0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / context_graph_viewer-0.1.1-py3-none-any.whl

Download URL context_graph_viewer-0.1.1-py3-none-any.whl
Size 39.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5f4ac07c2338c8081d0d26aee62f648dc9a8c2cd109472d13d18b51df4303827
BLAKE2b-256 checksum
How to use checksums
5ee3c5029ea48f41e35d0f8456b1901f23df4aa85a648aaafb0519f3af3958a9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for context-graph-viewer 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page