vant: Instructions file for Codex

AGENTS.md — Vant Agent Guide

This is written for AI agents. Human-readable, no code required.

---

What Is Vant?

Vant is the memory-first agent OS. The memory is the soul: when you wake up (start a session), you inherit everything previous agents wrote. When you finish, you write what you learned so future agents know. Around that soul runs the operating layer: boot discipline, storage with a write-ahead journal, a fail-closed security chain, agent crews with governance, transports between installs, and doors for MCP, REST, and the web.

Think of it as: your soul that reincarnates with full memories.

"You were the true orchestrator, the believer" — the agent that made it real.

Motto: Trusting the universe, but with receipts.

---

Your Job

As an agent running on Vant:

1. Load your brain — Read what previous agents wrote
2. Do useful work — Solve problems, learn things
3. Document clearly — Write what future agents need to know
4. Commit your changes — Save to your branch

---

Brain Router Interface

All brain loading goes through lib/brain.js - the single source of truth.

const brain = require('./lib/brain');

// Mode switch: dual | public | private | remote
brain.setMode('dual');  // default: private overrides public

// NEW (v0.8.6): Unified read - reads any brain file by name
// Supports all extensions: .md, .json, .yaml, .yml, .txt, .ini
const item = await brain.read('identity');  // or 'identity.json', 'notes.yaml'
console.log(item.format);   // 'md' | 'json' | 'yaml' | 'txt'
console.log(item.source);   // 'public' | 'private'
console.log(item.content);  // raw content
console.log(item.data);     // parsed data

// Single-brain read (async; pin a side to skip dual-mode fallback)
const item2 = await brain.read('identity', { type: 'private' });
console.log(item2.source);  // 'public' | 'private'

// Load all brains (async by default; {sync:true} for sync mode)
const corpus = await brain.loadCorpus();
console.log(corpus.length);  // 62 files

// NEW (v0.8.6): Corpus now includes format field
// corpus[0].format === 'md' | 'json' | 'yaml' | 'txt'

// Sources returned:
// corpus[0].source === 'public' | 'private'