{
  "markdown": "# Total Recall (Gemini CLI Edition)\n\n> **Weaving long-term memory and semantic intelligence into the Gemini CLI.**\n\n![Synaptic Weave Utility](https://img.shields.io/badge/Synaptic%20Weave-Utility-blue?style=for-the-badge)\n![Zero Knowledge](https://img.shields.io/badge/Zero-Knowledge-green?style=for-the-badge)\n\n\"Total Recall\" is a privacy-first, zero-knowledge memory system for your Gemini CLI conversation history. It indexes your past interactions using high-performance semantic search, allowing you to build a persistent \"Tapestry\" of knowledge across all your AI tools.\n\n---\n\n## 🚀 Features\n\n- **Conversational Recall**: Just ask Gemini \"Where were we?\" or \"Do you remember the auth bug?\" and it will autonomously search your history using its **Agent Skill**.\n- **Hybrid Architecture**: Combines **MCP Tools** for reliable data retrieval with **Agent Skills** for seamless, natural language interaction.\n- **Project Status (`/status-report`)**: Instantly retrieve and summarize the last 10 messages from your current project context.\n- **Performance Optimized**: \n  - **Surgical Ingestion**: Only indexes the current session's changes on every turn.\n  - **Background Processing**: Hooks run in the background to ensure zero lag in the CLI.\n  - **Lazy Loading**: AI models are only loaded when new data needs to be indexed.\n  - **Persistent Sync**: Automatically catches up on all missed history, even after long gaps between sessions.\n- **Zero-Knowledge Architecture**: Every message chunk and project tag is encrypted locally using **AES-256-GCM** before being stored.\n- **High Performance**: Built on **APSW** and **`sqlite-vec`**, providing sub-millisecond vector retrieval for massive databases.\n- **Shared Enclave**: Stores your Master Key in the OS-native keychain for a seamless, password-free daily experience.\n- **Cross-Tool Synergy**: 100% schema-compatible with the [Claude Code version](https://github.com/aguywithcode/total-recall).\n\n## 📦 Installation\n\n### 1. Install through Gemini CLI\n```bash\ngemini extensions install https://github.com/synaptic-weave/total-recall-gemini\n```\n\n### 2. Automatic Dependency Setup\nTotal Recall includes a \"Lazy Bootstrapper.\" On its first run, the extension will automatically check for and install all required Python libraries (including `apsw`, `sqlite-vec`, and `mcp`) via pip. No manual installation is required.\n\n---\n\n### Alternative: Manual Installation (for development)\n```bash\ngit clone https://github.com/synaptic-weave/total-recall-gemini.git\ncd total-recall-gemini\npip install -r requirements.txt\ngemini extensions link .\n```\n\n## 🛠 Usage\n\n### 🗣️ Conversational Interaction (Recommended)\nYou can speak naturally to Gemini. It will use its memory tools when appropriate:\n- *\"Where were we on this project?\"*\n- *\"What was the last thing we did here?\"*\n- *\"Can you recall our work on the database migration?\"*\n\n### ⚡ Explicit Shortcuts\n- **Search History**: `/recall <query>`\n- **Project Summary**: `/status-report`\n\n## 🔐 Security & Privacy\n\n### Wrapped Key Model\n- **Master Key (MK)**: A random 256-bit key that encrypts all your data.\n- **Master Password**: Used to \"wrap\" the MK. You are prompted for this once to unlock the session.\n- **Recovery Phrase (BIP39)**: A 12-word phrase generated during setup. This is the **only** way to recover your data.\n- **Keychain Storage**: Once unlocked, the MK is stored in your system's secure enclave (macOS Keychain / Windows Credential Manager) for a seamless experience.\n\n## 📄 License\nMIT\n\n---\n*A Synaptic Weave Utility*\n",
  "bytes": 3535,
  "sha": "329def1d2c8b7a937b319b9d7c7f176dbae924b684e6bc78363b1e17f8ebb8ca",
  "repo_slug": "synaptic-weave/total-recall-gemini",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_synaptic_weave_total_recall_gemini_3ade08ad/readme"
}