Skip to main content
Glama


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: .ods (LibreOffice), .sqlite, .md

Clunky browser tabs you forget to check

Omnipresent Desktop HUD (Cmd+Shift+Y) over Cursor & VS Code


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 !urgent tags.

  • 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 in Inbox.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, OpenYantraRetriever

  • CrewAI: OpenYantraCrewMemory for multi-agent autonomous teams


πŸš€ Install in One Command

macOS / Linux:

curl -sSL https://raw.githubusercontent.com/revanthlevaka/OpenYantra/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/revanthlevaka/OpenYantra/main/install.ps1 | iex

Python 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

yantra bootstrap

Interactive 12-question interview to build your Chitrapat vault

yantra desktop

Launch native Desktop App & floating HUD palette (yantra app / yantra hud)

yantra tui

Open interactive Cyberpunk Terminal TUI

yantra mcp setup

Auto-configure Claude Desktop and Cursor MCP settings

yantra mcp serve

Run the standard MCP JSON-RPC server on stdin/stdout

yantra dream

Run autonomous Nidra memory consolidation (yantra consolidate)

yantra vault sync [dir]

Bi-directional sync with Obsidian Markdown vault (export / import)

yantra hook install

Install Git post-commit auto-ingest hook in current repo

yantra morning

Display your daily briefing, streak, and active open loops

yantra context

Compile dynamic context and copy Markdown to clipboard

yantra loops

List and filter unresolved open loops

yantra health

Run complete database integrity and health diagnostics

yantra doctor

Verify system environment, SQLite WAL, and vector embedders

yantra ui [--port 7331]

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 (livingbrain.com)

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 (.ods), Obsidian Markdown

Desktop Ergonomics

Browser dashboard

Browser dashboard

Floating HUD (Cmd+Shift+Y), Cyberpunk TUI

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 & - [x] sync

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


Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    C
    maintenance
    Portable 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
    -
  • A
    license
    Not graded
    quality
    C
    maintenance
    Persistent, 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.
    4
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides 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 npm
    2
    MIT