memory-atlas

01 · problem

Belief is not a vault.

Agents store what they thought. Fleets need what was verified against the tree. Unverified cards wear the costume of done.

Stale prose without a seal
Map mixed with ledger history
Ghost globs · zero hits · silent

02 · the seal

Press only what you reviewed.

The hand is the honesty. verifiedAt is a seal in clay — review first, stamp after, never for theater.

v02 · stamp press · press only what you reviewed

Until the hand presses, the honest string is unverified. Gaps stay visible on the wall. The bleed hero shows the map; this section is the law of the hand.

03 · solution

Code-verified memory.

Map vs Ledger

Present zones on the wall. Past decisions freeze in the ledger.

owns.globs

git ls-files is the truth. Zero hits = hard error.

verifiedAt

SHA after human review — or unverified. No fake green.

04 · pillars

What the clay keeps

Plain vault

Markdown + YAML. Greppable.

Generated index

atlas build · gaps visible.

Honest freshness

From git history, not vibes.

Zero runtime deps

Thin toolchain. Travels with the repo.

05 · optional visuals

Look at the vault — without bloating the CLI.

Core stays zero-dep. Want a gallery of digests, diagrams, and typeset notes? Wire the companion package when you need it.

Data plane · vault · atlas check · stamp. No React.

memory-atlas-visuals

Presentation plane · MDX digests · Excalidraw · gallery on :4555.

Opt-in only

visuals.enabled in config · separate npm · never imported by core.

optional visuals

$ npm i -D memory-atlas memory-atlas-visuals

#1 Core + companion (devDependencies)

$ // atlas.config.json → "visuals": { "enabled": true }

#2 Declarative opt-in (defaults off)

$ atlas visuals init --write && atlas wire all

#3 Scaffold visuals/ tree · vendor atlas-skin skills

$ atlas-visuals dev

#4 Gallery · digests under vault visuals/ · port 4555

✓ Full recipe: docs · Visuals companion · npm memory-atlas-visuals

06 · quickstart

Raise the vault

Four clicks. Copy each line. Stamp only what you reviewed.

setup

$ npm install -g memory-atlas

#1 Install globally — bins: atlas · memory-atlas

$ atlas init

#2 Scaffold the vault in this repo

$ atlas check

#3 Verify claims + ledger

$ atlas stamp <slug> && atlas build

#4 Stamp reviewed zones, rebuild index

✓ Prefer memory-atlas if MongoDB Atlas CLI owns atlas on PATH.

Stamp only what you reviewed

Bleed hero. Centered seal. MIT.

GitHub →

The Titan is the headline.