-
-
Notifications
You must be signed in to change notification settings - Fork 7
Home
Persistent teammate memory for any AI assistant — across every surface. Ein persistentes Teammate-Gedächtnis für jeden AI-Assistenten — über jede Oberfläche hinweg.
Bastra.Recall (the OSS package bastra-recall, a.k.a. Bastra Bridge) is a long-term memory layer for AI assistants. One local daemon holds a Markdown vault and serves every MCP- or HTTP-speaking client at the same time — Claude Code, Claude Desktop, Cursor, ChatGPT (Custom GPT Actions), and your own scripts.
It does three things, autonomously:
- Save — when a lesson is learned (a correction, a durable rule, a finalized decision), the assistant writes it to the vault without being asked.
- Recall — before acting, not only when prompted: before writing code, before a plan, at session start.
- Apply — the recalled lesson changes what the assistant does next.
The single success metric: the user doesn't have to think for the AI anymore.
| Page | What it covers |
|---|---|
| System Requirements | Supported platforms (macOS today, Windows planned), the three embedding modes (Ollama / OpenAI / BM25) and how to enable them, and the hardware footprint. |
| Architecture | The components (core, daemon, forwarder, skill, statusline), the one-daemon-many-clients model, and the request flow — including the non-obvious path the MCP recall tool actually takes. |
| How Recall Works | The ranking pipeline (BM25 → vector → RRF → hops → staleness), the query cache, lean-vs-full payloads, and the score floor. |
| Tools Reference |
recall, load_memory, save_memory, find_document — parameters, the verbosity flag, and the exact lean/full shapes. |
| Statusline | The two live-feedback channels in Claude Code — the persistent statusline segment (per-turn calls/hits/ms + banter) and the progress line under a running tool call. Setup, banter config (BASTRA_BANTER*), and limits. |
| Updating | The status panel (bastra), release detection, update.mode (notify/auto/off), the opt-in session-start auto-update, and bastra update. |
🟢 Early alpha. Read path (recall/load) and save path are functional; the reflex layer ships two of four hooks (PreToolUse, SessionStart). The vault is plain Markdown + YAML frontmatter, Obsidian-compatible, and lives on your own machine.
Bastra.Recall (das OSS-Paket bastra-recall, alias Bastra Bridge) ist eine Langzeitgedächtnis-Schicht für AI-Assistenten. Ein lokaler Daemon hält einen Markdown-Vault und bedient gleichzeitig jeden MCP- oder HTTP-fähigen Client — Claude Code, Claude Desktop, Cursor, ChatGPT (Custom GPT Actions) und eigene Skripte.
Er tut drei Dinge, autonom:
- Speichern — wenn eine Lesson entsteht (eine Korrektur, eine dauerhafte Regel, eine finale Entscheidung), schreibt der Assistent sie ungefragt in den Vault.
- Abrufen (Recall) — vor dem Handeln, nicht nur auf Aufforderung: vor Code, vor Plänen, beim Session-Start.
- Anwenden — die abgerufene Lesson verändert, was der Assistent als Nächstes tut.
Die eine Erfolgsmetrik: Der User muss nicht mehr für die AI mitdenken.
| Seite | Inhalt |
|---|---|
| System Requirements | Unterstützte Plattformen (macOS heute, Windows geplant), die drei Embedding-Modi (Ollama / OpenAI / BM25) und ihre Aktivierung, plus der Hardware-Fußabdruck. |
| Architecture | Die Komponenten (core, daemon, forwarder, skill, statusline), das Ein-Daemon-viele-Clients-Modell und der Request-Flow — inklusive des nicht-offensichtlichen Pfads, den das MCP-recall-Tool tatsächlich nimmt. |
| How Recall Works | Die Ranking-Pipeline (BM25 → Vector → RRF → Hops → Staleness), der Query-Cache, lean-vs-full-Payloads und der Score-Floor. |
| Tools Reference |
recall, load_memory, save_memory, find_document — Parameter, das verbosity-Flag und die genauen lean/full-Formen. |
| Statusline | Die zwei Live-Feedback-Kanäle in Claude Code — das persistente Statusline-Segment (Pro-Turn calls/hits/ms + Banter) und die Progress-Zeile unter einem laufenden Tool-Call. Einrichtung, Banter-Konfig (BASTRA_BANTER*) und Grenzen. |
| Updating | Das Status-Panel (bastra), Release-Erkennung, update.mode (notify/auto/off), das Opt-in-Auto-Update am Session-Start und bastra update. |
🟢 Frühe Alpha. Read-Pfad (recall/load) und Save-Pfad funktionieren; die Reflex-Schicht liefert zwei von vier Hooks (PreToolUse, SessionStart). Der Vault ist reines Markdown + YAML-Frontmatter, Obsidian-kompatibel, und liegt auf deinem eigenen Rechner.