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)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| context_graph_viewer-0.1.1.tar.gz | 45.5 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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.