HolosOAD is the Rust successor to and replacement for graphify (Python
knowledge-graph builder) and the Agent Deck Execution Engine — one
always-on local daemon maintaining a live vector map, persona map, and dynamic documentation for
a solution of any size, served to Claude Desktop and any other MCP client with deterministic
token-reduction machinery. The binaries are holosoad (CLI), holosoadd (daemon), and
holosoad-mcp (stdio MCP shim); the old graphify/graphifyd/graphify-mcp names are kept as
compatibility aliases. New solutions use a .holoslabs/ data directory (existing .graphify/
solutions keep working untouched). Internal crate names (gue-*) and GUE-FR-x.y requirement
IDs retain the GUE prefix.
This repository is the home of the unified project. The Python implementation and agent-deck
donor code remain in the reference checkout at ../graphify-8/ (expected as a sibling directory;
it is the semantic reference and benchmark baseline, and is not modified from here).
The workspace embeds Quatzal's Windows-safe engine crates from crates.io — quatzal-vector
(durable vector index), quatzal-graph (temporal weighted expansion), and quatzal-schema.
No sibling checkout is required; to develop against a local Quatzal tree, uncomment the
[patch.crates-io] block in the root Cargo.toml. The holosoad quatzal export subcommand
emits Quatzal-wire JSONL, and scripts/quatzal-push.py bulk-loads that output into a running
Quatzal server.
HolosOAD/
├── Documents/ # design document set — START HERE (Documents/README.md)
│ ├── PRD.md # vision, goals G1–G4, gates M1–M6
│ ├── SRS.md # requirements (GUE-FR-x.y)
│ ├── Architecture.md # process model, crates, store, decision spikes D1–D5
│ ├── Roadmap.md # phases 0–6, task ledger, exit gates
│ ├── FeatureMap.md # per-module disposition: port / plugin / absorb / drop
│ ├── appendix/ # normative MCP schema appendix
│ └── decisions/ # spike verdicts (D1–D5) + benchmark environment
└── (Cargo workspace lands here in Phase 0 — task T0.1)
Read Documents/README.md, then begin at Roadmap Phase 0, task T0.1. Hard rules: every task
cites GUE-FR-x.y requirement IDs; TDD throughout; phase exit gates are hard gates; Python
graphify (../graphify-8/) is the semantic reference, never the design.
MIT — see LICENSE.
Rust successor to and replacement for graphify by
Safi Shamsi (MIT). GUE ports or adapts behavior from that original per the disposition recorded
in Documents/FeatureMap.md; the Python original is unmodified at the
reference checkout this repo treats as read-only (../graphify-8/).