Desktop UI
Noumenon ships an experimental Electron preview that visualizes the knowledge graph. noum open auto-downloads it and points it at the local daemon.
Very early proof of concept. The desktop UI is a preview of where Noumenon is heading, not a supported surface yet. Expect rough edges, breaking changes, and missing features. The CLI and MCP integrations are the supported ways to use Noumenon today; pick this up when you want to look rather than ship.
How to Try It
Run noum open. On first call the launcher fetches the latest packaged build from leifericf/noumenon-app releases (a Noumenon-*.dmg on macOS, Noumenon-*.AppImage on Linux), extracts it under ~/.noumenon/ui/, and launches. Subsequent calls reuse the cached app.
The desktop app talks to the same local daemon as the CLI and the MCP server. There's nothing extra to start; if noum works, noum open works.
What's in the Preview Today
- Force-directed graph at the macro level. Nodes are components, edges are dependencies from the synthesize stage. Drag nodes around, hover for component summaries.
- Drill-down from a component into the files it owns, then from a file into its segments (functions, classes, types) with complexity ratings and code smells inline.
- Floating Ask overlay that talks to the same Ask agent as
noum ask. Useful when you want to query while staring at the graph.
Things that are not in the preview yet: editing settings, managing tokens for shared instances, viewing benchmark or introspect runs, and a bunch of polish you'd want before calling it a real GUI. The CLI covers all of those today.
Where the Source Lives
The Electron app is its own repo: leifericf/noumenon-app. Issues and feature requests are welcome there. The auto-download logic on the launcher side is in launcher/src/noum/electron.clj.
If you'd rather not download an Electron app on first run, skip noum open and stay with the CLI, MCP, or HTTP API. Nothing in the desktop UI is exclusive; it's a different lens on the same graph.