Agent memory you can inspect and trust.
Helios is a private, multi-tenant knowledge OS on Cloudflare. It preserves raw sources, compiles them into maintained pages with inspectable citations, and keeps trust changes human. Every connected agent reads the same vault contract through MCP; the console makes evidence, review queues, deterministic retrieval, system health, and portable export visible. The current implementation closes the first-value loop: add one real source, inspect one cited page, reuse it from an agent, then make the trust decision yourself. Hobby uses the connected agent for compilation; Pro and Team may start asynchronous hosted ingest. Deterministic Ask finds the strongest evidence section rather than pretending to be chat.
- 01
Raw source
Store the original material and keep the returned raw id as its canonical address.
- 02
Cited page
Compile a seedling that separates extracted evidence from inference and links back to raw bytes.
- 03
Human review
Compare the page with its source. Agents may request review; only a human changes trust.
- 04
Agent reuse
Load the live contract and retrieve the maintained evidence from another session or client.
Field manuals
implemented nowchoose by the decision in front of youOrient to Helios
Choose create, connect, or inspect. Learn the source-to-trust mental model and the role boundaries before changing a vault.
GUIDEReach first evidence
Create a vault, add a bounded source, connect a supported client, inspect its citation, decide trust, and query it again.
TECHNICALConnect and debug
Use exact Codex, Claude Code, or Copilot CLI setup; browse all 15 tools; handle 402/409 states; verify lineage and export.
MOATDefend the wedge
Trace category compression, verified whitespace, the compounding trust loop, shipped proof, competitive boundaries, economics, and risks.
The system
implementation detailwhat was built, how it works, how to run itWhat we built & how it works
The whole product in one page: the compiled-wiki bet, the deterministic brain, the trust lifecycle, the six-phase build ledger and appended remediation — with the real retrieval algorithm running live in your browser.
02Design & architecture
DO-per-vault isolation, the mixed Hono/Astro vertical-microfrontend router, the data plane schema, the contextual-RAG search pipeline, and the seven isolation invariants — every box on the map is clickable.
03Operate & deploy
Local dev topology, the exact staging deploy sequence (bootstrap cycle included), secrets, readiness gates, backups, alarms, and the runbook — step through the deploy interactively, then copy it.
04Vault contract & build ledger
The original implementation chapter for account setup, vault isolation, the console/write-plane split, and the agent operating contract. Use the field manuals above for the current activation path.
Field notes
the blogthe ideas behind the product, for newcomersThe Compiled Mind
Why we stopped retrieving and started compiling. The Karpathy LLM-Wiki idea, the OKF page contract, PARA + Zettelkasten living together, and retrieval with zero model calls — animated, so you feel it before you read it.
FN·2Your First Vault
The synopsis: what the local reference system proved, where Helios comes in, and the shortest path from an empty vault to an agent that reads, writes, and cites — with a terminal that types it out for you.
Start here
shortest pathspick by what you need right now| You want to… | Go to | Time |
|---|---|---|
| Choose whether to create, connect, or inspect | Start · Orientation | ~3 min |
| Reach one source-backed page and reuse it | Guide · First evidence | ~7 min |
| Configure or troubleshoot an MCP client | Technical · Runbook | ~10 min |
| Understand the evidence-backed defensibility thesis | Moat · Founder deck | ~15 min |
| Understand the idea before anything else | FN·1 The Compiled Mind | ~8 min |
| Read the original vault-contract implementation chapter | 04 Vault contract | ~15 min |
| Audit the architecture & isolation story | 02 Architecture | ~20 min |
| Deploy or operate an instance | 03 Operations | ~12 min |
| Read the authoritative build spec | BUILD_PROMPT.md (repo root) | deep dive |
| See the usemux design-adoption plan | RESKIN_PLAN.md (repo root) | ~6 min |