Personal AI Memory System -- v3.0.0

Your context.
Your file.
Your control.

OpenYantra is a local-first memory system for personal AI agents. One human, one file, full auditability. No cloud. No database. No lock-in. v3.0 brings 2ms SQLite writes.

1
Memory file
14
Domain sheets
2ms
Write latency
MIT
License
~/Chitrapat.ods SQLite WAL -- v3.0.0
Memory
Ledger
Loops
Agents
Episodic
247
Semantic
133
Prospective
89
Beliefs
41
14
Sheets
4
Agents
3
Inbox
2ms
Write
02 / Architecture

Built on non-negotiable invariants.

OpenYantra enforces six architectural invariants that can never be broken. v3.0 adds SQLite WAL as the operational layer -- ODS remains the human-readable canonical export.

01
Single Memory File
All persistent memory lives in Chitrapat.ods. Human-readable, portable, directly editable. v3.0 adds SQLite as the fast operational layer -- ODS is the canonical export.
Canonical Source
02
Single Writer Rule
Only Chitragupta writes to memory. All other agents are read-only. Write flow: Agent -> Sanchitta -> Chitragupta -> SQLite WAL -> async ODS export.
LedgerAgent
03
14 Domain Sheets
Memory structured across 14 sheets: Identity, Goals, Projects, People, Tasks, Open Loops, Session Log, Inbox, and more. Domain separation enforced.
14 Domains
04
Full Auditability
Every write logged, timestamped, SHA-256 signed. The Agrasandhanī is append-only. Audit capability can never be removed.
SHA-256
05
Local-First
Runs fully offline. No cloud dependencies. Your data never leaves your machine. External LLMs optional.
Offline
06
Lightweight Retrieval
VidyaKosha uses BM25 and TF-IDF tuned for 100-5000 records. Optional dense embeddings. No heavy infrastructure.
VidyaKosha
v3.0 Write Flow -- 2ms on hot path
01
Agent
Any AI agent
02
Sanchitta
Crash-safe queue
03
Chitragupta
Sole writer
04
SQLite WAL
2ms operational
05 async
Chitrapat.ods
Atomic export
03 / CLI Interface

One command.
Zero friction.

The CLI is the primary interface. Every command is short, predictable, scriptable. v3.0 adds `yantra morning`, `yantra context`, and `yantra sync`.

yantra morningDaily brief on first command›
yantra inbox "idea"Capture to queue›
yantra contextCopy to clipboard, paste into any AI›
yantra loopsShow open loops›
yantra healthFile + ledger check›
yantra syncImport LibreOffice edits to SQLite›
yantra -- zsh
$yantra morning
Good morning, Revanth. 3 day streak
2 loops urgent -- Decide structure (2d left)
Stale: Feature Screenplay -- 9 days
$yantra inbox "Priya -- budget by Friday"
Queued WriteID: #a3f9d2c1
SQLite WAL: 2ms -- 248 records
$yantra context
Context copied to clipboard.
Paste into Claude.ai, ChatGPT, etc.
$
04 / Agent Ecosystem

Many agents.
One memory.

Multiple AI agents share a single memory file. Each has a defined role. The architecture prevents conflicts, enforces auditability, and keeps the human in control of every record.

Agents -- Read Only
Retrieval
VidyaKosha
BM25/TF-IDF semantic search. Optional dense embeddings.
Read
Framework
Claude / ChatGPT
Read context via build_system_prompt_block()
Read
Framework
OpenClaw / LangChain
Session hooks: start, pre_compact, post_compact, end
Read
Capture
Telegram / iOS / Email
Mobile capture routes to Inbox via trust tier 1
External
All writes routed through Chitragupta
Sole Writer
LedgerAgent
Chitragupta
Only agent with write access. Signs every record SHA-256. Routes through Raksha security scan. Single-writer rule enforced across all frameworks.
Write
SQLite WAL (2ms) then async ODS export
Chitrapat.ods
Canonical Memory -- v3.0 SQLite + ODS
Source of Truth
Read Only
Write (Chitragupta only)
External / Inbox
SHA-256 Signed
01
Simple
One file. One writer. No hidden side effects. Complexity is rejected at design time.
02
Inspectable
Every record human-readable. Every write auditable. You own the full stack.
03
Local
Runs fully offline. No telemetry. No cloud. Your cognition, on your machine.
04
Human-Controlled
The .ods file is always editable by you. AI assists. You decide what persists.
05 / Live Simulation

See it
in action.

Simulate the yantra CLI without installing anything. Click a command or type your own. v3.0 commands included.

yantra -- simulation v3.0.0
Records247
Open Loops12
BackendSQLite WAL
Last Writejust now