Skip to content

armgit / mso

Public Imported from GitHub
0

Browser-based graphical shell and control plane for a Linux server you own — real terminal, file manager, live metrics and BYOK AI in one mobile-first workspace. Next.js 16 · React 19 · node-pty · Tailwind v4 · shadcn/ui. Public alpha, self-hosted.

2.9 KB
Raw Blame

Memory graph

Owner-only knowledge graph inside the MSO shell. Open it from Launchpad or Spotlight as Memory, at /memory, or with mso memory-graph [project].

The graph is built on the server by GET /api/v1/memory-graph and rendered in the browser. It does not use Convex, and it does not require Obsidian. Layout ideas — web (force), radial rings, layered hop columns, a local neighbourhood, ghost nodes for unresolved [[wikilinks]], and folder/group color — follow open-silong frontend/slices/memory-graph (MIT). The implementation is MSO-native.

This is separate from the Workflow session graph. The pinned Memory app also projects bounded owner-only Organization, saved workflow and learned-recipe metadata with links back to their source apps. See Memory safety for the exact scope, privacy boundaries and remaining limits.

What becomes a node

  • Markdown notes under an optional vault directory. Set OS_MEMORY_GRAPH_ROOT, or type a path in the app. The path must pass the normal read-root jail. ~/vault is on the sensitive-home denylist; ~/notes or ~/obsidian/vault are usable when they sit inside OS_FS_READ_ROOTS.
  • .mso/KNOWLEDGE.md and a bounded set of repo-local .agent memory records for a named project. With no vault and no project, the scan includes up to four discovered projects.
  • Typed agent memory for the signed-in device (cli:<device id>, the same principal Alfa Cockpit uses). Private and restricted claims show as “Private memory”.
  • Assistant memories from the owner memory store.

[[Title]] links resolve to a note with that title or path. Anything unresolved is a ghost. Relative .md links become edges when the target file is in the graph. Folder hubs connect two or more notes in the same top-level folder.

Using the view

  • Web, Radial, and Layered rearrange the same nodes.
  • Local keeps the selected node and its neighbourhood. Hops are 1–4. With nothing selected, the highest-degree node is the centre.
  • Ghosts, Tags, and Orphans toggle those nodes. Group chips hide a color group.
  • Click a node to select it. Click it again, double-click it, or press Open to open a note that has a file path in Code.
  • Agent Vault opens Memory with its selected snapshot directory and repository as explicit window context. This does not change the saved default root. Vault backlinks reuse this owner-only projection on demand, without loading the graph renderer in the note reader.
  • Drag the background to pan. Scroll to zoom.

The scan is capped (notes, depth, directories, project records) and may report that it truncated. Excerpts are redacted for obvious secrets. The route is owner-only; Viewer and Operator are refused.

Deploy

Merging to main does not rebuild a running MSO service. On the host, update with:

mso update