OpenYantra
Provides OpenYantraCrewMemory for CrewAI multi-agent teams to use OpenYantra as persistent memory.
Installs a Git post-commit hook that auto-ingests commit hashes, branches, messages, and modified files into OpenYantra session logs.
Provides LangChain adapters including OpenYantraChatMessageHistory and OpenYantraRetriever for using OpenYantra memory in LangChain workflows.
Provides bi-directional Obsidian vault sync, exporting memory as Markdown with YAML frontmatter, wikilinks, and task checklists, and importing checked-off tasks and inbox notes back into the ledger.
Integrates with local Ollama models for autonomous sleep consolidation, using models like llama3, mistral, and phi3 with fallback to deterministic heuristics.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
The Problem -- Why Your AI Forgets
Every time you open a new chat with Claude, ChatGPT, Cursor, or terminal agents, they start completely blank. They don't know your active projects, architectural decisions from last week, or what you left unfinished. You repeat yourself every session.
When conversation context windows fill up, the AI compresses older messages -- your active work context vanishes mid-task.
OpenYantra solves this permanently:
Without OpenYantra | With OpenYantra |
AI starts completely amnesiac every session | AI knows your projects, goals, beliefs, and contacts |
Repetitive prompt engineering every day | Dynamic context block compiled & injected in milliseconds |
Unfinished work lost in context compaction | Open Loops (Anishtha) flushed before compaction & restored after |
Accidental API keys & secrets leak into agent memory | Raksha Credential Redactor automatically sanitizes tokens |
Trapped in proprietary vector database clouds | 100% open local files: |
Clunky browser tabs you forget to check | Omnipresent Desktop HUD ( |
Related MCP server: 1AIVault
β‘ What's New in v6.1 ("Akasha & Sutra") & Desktop v1.0
1. π₯οΈ OpenYantra Desktop & Floating HUD (Cmd+Shift+Y)
No more opening browser tabs. Run yantra desktop (or yantra hud) to launch an ultra-lightweight native OS HUD (< 15MB binary, zero Electron bloat). Press Cmd+Shift+Y to trigger a Raycast/Spotlight-style floating palette directly over Cursor, VS Code, or your terminal.
Instant Capture: Quick-dump notes with
#project,@person, or!urgenttags.Instant Recall: Live fuzzy & semantic search across your entire knowledge base.
1-Click Sleep: Trigger autonomous memory consolidation right from the HUD.
2. β‘ 1-Click MCP Auto-Setup for Claude & Cursor (yantra mcp setup)
Zero manual JSON editing. One command auto-detects Claude Desktop and Cursor configurations across macOS, Windows, and Linux, creates a backup, and installs the OpenYantra MCP server seamlessly.
3. π Autonomous Sleep & Memory Consolidation (Nidra)
Mimics biological slow-wave sleep. Run yantra dream or yantra consolidate:
Episodic Clustering: Clusters recent session logs into macro-milestones and decisions.
Open Loop Auto-Resolution: Automatically identifies and closes loops resolved during work.
Preference Promotion: Promotes recurring user preferences (e.g., "prefers dark mode", "always use python 3.9") into foundational
Beliefs & Principles.Local Ollama Integration: Connects to local Ollama (
llama3,mistral,phi3) with automatic fallback to deterministic heuristics. Zero cloud dependency.
4. π Bi-Directional Obsidian Vault Sync (yantra vault sync)
Export: Translates your Chitrapat into clean Obsidian Markdown notes with YAML frontmatter, wikilinks (
[[Projects/X]]), and task checklists.Import: Check off an item (
- [x]) in Obsidian, and OpenYantra resolves it in the ledger. Add notes inInbox.md, and they are enqueued into your memory bank.
5. π‘οΈ Raksha Credential & Secret Redactor Guard
Pre-commit interceptor pattern-matches and redacts Anthropic, OpenAI, AWS, GitHub, Google API keys, Slack tokens, and private keys before committing any record to disk.
6. π Git Commit Auto-Ingest (yantra hook install)
Install a git post-commit hook in your repositories. Every time you commit code, OpenYantra automatically extracts the commit hash, branch, message, and modified files into your Session Log.
7. π Cyberpunk Terminal TUI (yantra tui)
For command-line purists and SSH workflows. An interactive terminal dashboard displaying live open loops, active projects, recent decisions, and quick-capture hotkeys.
8. π Drop-in Framework Adapters
First-class Python bindings for:
LangChain:
OpenYantraChatMessageHistory,OpenYantraRetrieverCrewAI:
OpenYantraCrewMemoryfor multi-agent autonomous teams
π Install in One Command
macOS / Linux:
curl -sSL https://raw.githubusercontent.com/revanthlevaka/OpenYantra/main/install.sh | bashWindows (PowerShell):
irm https://raw.githubusercontent.com/revanthlevaka/OpenYantra/main/install.ps1 | iexPython Package (Pip):
git clone https://github.com/revanthlevaka/OpenYantra.git
cd OpenYantra
pip install -e ".[full]"π οΈ Quickstart Workflow
# 1. Initialize your personal memory vault (12-question bootstrap interview)
yantra bootstrap
# 2. Configure Claude Desktop & Cursor with 1 click
yantra mcp setup
# 3. Launch the native Desktop HUD (or press Cmd+Shift+Y)
yantra desktop
# 4. View your Morning Brief in the terminal
yantra morning
# 5. Quick capture thoughts, tasks, or loops
yantra inbox "Follow up with Priya regarding the distributed consensus paper"
# 6. Run autonomous sleep consolidation at the end of the day
yantra dream
# 7. Sync with your Obsidian Vault
yantra vault sync ~/my_vault
# 8. Launch the Cyberpunk Terminal TUI
yantra tuiπ§ CLI Command Cheatsheet
Command | Action |
| Interactive 12-question interview to build your Chitrapat vault |
| Launch native Desktop App & floating HUD palette ( |
| Open interactive Cyberpunk Terminal TUI |
| Auto-configure Claude Desktop and Cursor MCP settings |
| Run the standard MCP JSON-RPC server on stdin/stdout |
| Run autonomous Nidra memory consolidation ( |
| Bi-directional sync with Obsidian Markdown vault ( |
| Install Git post-commit auto-ingest hook in current repo |
| Display your daily briefing, streak, and active open loops |
| Compile dynamic context and copy Markdown to clipboard |
| List and filter unresolved open loops |
| Run complete database integrity and health diagnostics |
| Verify system environment, SQLite WAL, and vector embedders |
| Launch the browser-based executive memory dashboard |
ποΈ System Architecture
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β OPENYANTRA UNIFIED ARCHITECTURE β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
[Omnipresent Inputs]
βββ Desktop HUD (Cmd+Shift+Y) βββββΊ [FastAPI Local REST Engine]
βββ System Tray Daemon βββββΊ [Port 7331 / Unix Socket]
βββ Git Post-Commit Hook βββββΊ β
βββ CLI & Cyberpunk TUI βββββΊ β
βββ IDE / Cursor MCP Client βββββΊ [Cognitive MCP JSON-RPC]
β
βΌ
βββββββββββββββββββββββββββ
β Raksha Redactor Guard β (Sanitizes keys & secrets)
ββββββββββββββ¬βββββββββββββ
β
βΌ
βββββββββββββββββββββββββββ
β Chitragupta SyncEngine β (Single-writer coordinator)
ββββββββββββββ¬βββββββββββββ
β
βββββββββββββββββββββββββββββββββ΄βββββββββββββββββββββββββββββββ
βΌ βΌ
[SQLite WAL Engine] [Canonical Life Scroll]
β’ < 2ms write latency β’ `chitrapat.ods`
β’ Sutradhar Graph Edges β’ ISO/IEC 26300 Open Document
β’ VidyaKosha Vector Index β’ LibreOffice Human-Readable
β β
βΌ βΌ
[Nidra Sleep Engine] [Obsidian Vault Sync]
β’ Episodic log clustering β’ Markdown with YAML frontmatter
β’ Open Loop auto-pruning β’ Checkbox bidirectional resolution
β’ Preference to belief promotion β’ Wikilinks [[Projects/X]]π The 14 Sacred Memory Sheets
OpenYantra stores your life context across 14 dedicated sheets in chitrapat.ods:
Sheet | Sanskrit | What it Stores |
π€ Identity | Svarupa | Persona, occupation, communication style, location |
π― Goals | Sankalpa | Long and short-term aims with success metrics |
π Projects | Karma | Active work -- domain, status, next concrete step |
π₯ People | Sambandha | Collaborators, relationship context, open threads |
π‘ Preferences | Ruchi | Tools, habits, rules, anti-goals |
π§ Beliefs | Vishwas | Values, worldview, epistemic evolution history |
β Tasks | Kartavya | Action items linked to projects with priorities |
π Open Loops β | Anishtha | Unresolved threads (Zeigarnik Effect safety net) |
π Session Log | Dinacharya | Chronological episodic summaries & git commits |
βοΈ Agent Config | Niyama | Per-agent behavioral guidelines and trust tiers |
π AgrasandhanΔ« | -- | Immutable ledger -- every write SHA-256 signed |
π₯ Inbox | Avagraha | Quick capture dumping ground -- routed later |
βοΈ Corrections | Sanshodhan | Agent-proposed edits pending human approval |
π Quarantine | Nirodh | Blocked prompt injections and quarantined inputs |
π§ͺ Verification & Test Suite
OpenYantra maintains a rigorous test suite covering security, vector search, passkey authentication, MCP configuration, Nidra consolidation, and desktop HUD endpoints:
pytest tests/============================= test session starts ==============================
platform darwin -- Python 3.9.6, pytest-8.4.2, pluggy-1.6.0
rootdir: /Users/revanthlevaka/openyantra
configfile: pyproject.toml
tests/test_adapters.py ... [ 4%]
tests/test_bootstrap.py ... [ 8%]
tests/test_cognitive.py ....... [ 19%]
tests/test_desktop.py .. [ 22%]
tests/test_git_hook.py ... [ 26%]
tests/test_mcp_setup.py ... [ 30%]
tests/test_nidra.py .... [ 36%]
tests/test_passkey.py ..... [ 44%]
tests/test_security_sanitizer.py ...... [ 52%]
tests/test_setu.py .... [ 58%]
tests/test_sutra.py .... [ 64%]
tests/test_sutradhar.py ............... [ 86%]
tests/test_tui.py . [ 88%]
tests/test_ui_api.py ..... [ 95%]
tests/test_vault.py ... [100%]
================== 68 passed, 4 warnings in 96.69s (0:01:36) ===================πΈ Screenshots & Visual Experience
Today Command Centre | Live Web Dashboard |
Terminal Cyberpunk TUI | Open Loops (Anishtha) |
βοΈ How OpenYantra Compares
Dimension / Capability | Living Brain ( | Mem0 / Zep | OpenYantra (v6.2) |
Hosting Model | Proprietary Cloud SaaS | Cloud SaaS / Complex Self-Host | 100% Local-First / Zero Cloud |
Data Sovereignty & Privacy | Third-party cloud servers | Third-party cloud servers | Your device only (Offline SQLite & ODS) |
Human Editability & Transparency | API / Closed web dashboard | Closed JSON / Vector embeddings | Open spreadsheet ( |
Desktop Ergonomics | Browser dashboard | Browser dashboard | Floating HUD ( |
Secret & Credential Redactor | β (Raw context sent over wire) | β (Requires manual masking) | β Raksha automatic regex sanitizer |
Sleep & Memory Consolidation | Cloud background job | β οΈ Basic clustering | β Local Ollama Nidra Consolidation |
Obsidian Vault Sync | β None | β None | β
Bi-directional Markdown & |
1-Click MCP Setup | β οΈ Manual config | β οΈ Manual config | β Auto-injects Claude & Cursor JSON |
Vendor Lock-in & Pricing | Monthly SaaS Subscription | Metered API Pricing | 100% Free & Open Source (MIT / CC0) |
ποΈ Mythology & Philosophy
Named in honour of Chitragupta (ΰ€ΰ€Ώΰ€€ΰ₯ΰ€°ΰ€ΰ₯ΰ€ͺΰ₯ΰ€€) -- the Hindu God of Data and divine scribe who maintains the complete ledger of every deed without prejudice or omission.
The architecture mirrors this philosophy precisely:
Single Trusted Recorder: Only Chitragupta may commit records to the ledger.
Dharma-Adesh: The user's righteous command always wins over agent assumptions.
Anishtha: Unfinished intent is preserved across context boundaries.
Mudra: Every write is permanently sealed with a SHA-256 digital signature.
The record exists to serve the remembered, not the recorder.
π Support OpenYantra
OpenYantra is free, local-first and open source. If it saves you time, you can support its development through GitHub Sponsors with monthly or one-time tiers. Sponsors are listed in SPONSORS.md.
Prefer to support with compute credits (for example Claude or Cursor credits)? Reach out through the contact details on my GitHub profile.
π License & Community
Protocol Specification: CC0 1.0 Universal (Public Domain)
Software Library: MIT License
Author: Revanth Levaka
This server cannot be deployed
Maintenance
Related MCP Connectors
One memory for Claude, ChatGPT and Cursor, kept on your computer. Optional sync, encrypted first.
Persistent memory for Claude Code and Cursor. Stop re-explaining your project every session.
Private memory for AI agents: save and recall facts across Claude Code, Codex, Cursor and ChatGPT.
Personal wiki and memory layer for AI assistants. Persistent, structured memory across sessions.
Related MCP Servers
- AlicenseAqualityDmaintenanceCross-surface persistent memory for Claude. Bridges context between Claude Chat, Code, and Cowork via local SQLite with full-text search.62 npm7MIT
- FlicenseNot gradedqualityCmaintenancePortable AI memory vault β save memories, skills, and configs to a local database and share them across Claude Desktop, Claude Code, Cursor, Cline, and more.1-
- AlicenseNot gradedqualityCmaintenancePersistent, shared memory for Claude across sessions and clients (Code, Desktop, Cowork) β deterministic diff reads, checkpoints, cross-client task handoff, and project-wide search. 100% local and deterministic, no API keys, no LLM summarization.4MIT
- AlicenseNot gradedqualityDmaintenanceProvides a local long-term memory layer for AI coding tools like Cursor and Claude Code, enabling cross-session, cross-tool sharing of project facts, user preferences, decisions, and workflows.21 npm2MIT