Bastra Recall

English · Deutsch

🇬🇧 English

Less repeating yourself. One shared memory for your AI tools.

Keep your preferences, decisions and hard-won fixes available beyond a single chat. Bastra Recall stores them as readable Markdown files on your computer and makes them available to your connected AI assistants.

Supported integrations help assistants save useful lessons and retrieve relevant memories before starting work. You can inspect and edit the files yourself, with Obsidian or any text editor. Automatic recall depends on the client integration and the assistant; it does not guarantee that every instruction will be followed.

Version 1.0 is available. Find published downloads in the latest release, changes in the changelog, and tested integrations in the support matrix.

Install

macOS — guided setup:

curl -fsSL https://bastra.io/install | bash

The script installs Homebrew if needed, installs Bastra Recall and starts setup. Choose a folder for your memories and the AI clients you want to connect. Read the installer before running it if you prefer.

macOS or Linux — with Node 22+:

npx bastra-recall install

No prior global npm installation is needed. Alternatively: npm install -g bastra-recall, then bastra install.

Restart your AI client after setup. Claude Desktop needs its one-time memory setup; Codex users should review and trust the installed hooks as described in the Codex guide.

Run bastra doctor to check the setup; bastra doctor --fix repairs registrations. Other installation methods cover the macOS download, source builds and manual configuration.

Try your first memory

1. Tell your assistant: “Remember: for this project, explain your changes briefly and include how you checked them.”
2. Ask it to show the saved memory so you can check the wording.
3. Start a new session and ask: “What are my preferences for explaining changes in this project?”

You can repeat the lookup in another connected client using the same vault. This is a simple way to check that your tools share the memory; supported hooks also help surface relevant context during normal work.

Supported surfaces

Other MCP clients can connect through the forwarder, but are untested. Scripts and other integrations can use the REST API. MCP is the protocol that lets an AI assistant use external tools such as this memory service.

Supported platforms

Why

A project decision made on Monday should still be available on Thursday, even if you switch AI tools. Bastra Recall gives those tools a shared place to look:

• Keep useful context: preferences, decisions, project facts and lessons from solved problems.
• Recall before work: supported hooks surface context at session start and before actions; the shared Skill guides the assistant's own searches and saves.
• Own the files: memories are plain Markdown with structured metadata, readable and editable outside Bastra.
• See what is remembered: bastra map opens the local vault map for browsing, search and memory care.

Examples from a working week show how these fit together.

Privacy and control

Storage and keyword search are local. When your assistant retrieves a memory, it receives that content as context; a cloud-based assistant may process it with its provider. Local storage does not make the whole AI session offline.

Semantic search is optional. bastra embeddings on sets up local Ollama embeddings; bastra embeddings off returns to keyword search. Choosing OpenAI embeddings explicitly sends queries and indexed memory text to OpenAI. Privacy and network use explains these paths, file sync and optional network features.

A vault in iCloud, Google Drive or Dropbox uses that service's synchronization. Concurrent edits on multiple computers can conflict, including with Bastra's automatic metadata updates. Bastra does not provide managed multi-device synchronization. Keep backups and check conflicting copies before replacing a file.

Guides

• Import existing memories — lists, chat exports, rules and memory folders. Folder imports go directly into a separate intake area; the other paths stage candidates for review.
• Vault map — explore, search and flag memories for care.
• Updates — update with bastra update, or opt into automatic updates.
• Product docs — let the assistant maintain user guides for your projects.
• Bastra Commons — optional community recipes with verification records.
• Usage and troubleshooting · Memory format · Architecture · Hooks · Save and recall triggers · Taxonomy · Valence and reflex

Roadmap

Version 1.0 focuses on measured recall quality, relevant session context and clearer control over memory use. The cumulative session context budget is being measured in shadow mode; it does not yet enforce a live session-wide limit. Roadmap and release boundaries.

A native Bastra Mac app is in development. The open-source package already includes the local browser-based vault map and works independently of that app.

License and contact

MIT — see LICENSE. The statusline includes owloops/claude-powerline under its retained MIT license.

Ask a question · Report a bug · Contribute · Support the project. Report vulnerabilities privately via SECURITY.md.

Built by Daniel / @n0mad-ai.

---

🇩🇪 Deutsch

Weniger wiederholen. Ein gemeinsames Gedächtnis für deine KI-Tools.

Bewahre deine Vorlieben, Entscheidungen und erarbeiteten Lösungen über einzelne Chats hinweg. Bastra Recall speichert sie als lesbare Markdown-Dateien auf deinem Rechner und macht sie deinen verbundenen KI-Assistenten zugänglich.

Unterstützte Integrationen helfen Assistenten, wichtige Erkenntnisse zu speichern und relevante Erinnerungen vor neuen Aufgaben abzurufen. Du kannst die Dateien selbst prüfen und bearbeiten – mit Obsidian oder jedem Texteditor. Automatischer Abruf hängt von der Integration und dem Assistenten ab; er garantiert nicht, dass jede Anweisung befolgt wird.

Version 1.0 ist verfügbar. Veröffentlichte Downloads findest du im aktuellen Release, Änderungen im Changelog und getestete Integrationen in der Support-Matrix.

Installation

macOS – geführtes Setup:

curl -fsSL https://bastra.io/install | bash

Das Skript installiert bei Bedarf Homebrew, installiert Bastra Recall und startet die Einrichtung. Wähle einen Ordner für deine Erinnerungen und die KI-Clients, die du verbinden möchtest. Du kannst das Installationsskript vorher lesen.

macOS oder Linux – mit Node 22+:

npx bastra-recall install

Eine vorherige globale npm-Installation ist nicht nötig. Alternativ: npm install -g bastra-recall, danach bastra install.

Starte deinen KI-Client nach der Einrichtung neu. Claude Desktop benötigt das einmalige Memory-Setup; bei Codex prüfst und bestätigst du die installierten Hooks wie in der Codex-Anleitung beschrieben.

bastra doctor prüft die Einrichtung; bastra doctor --fix repariert Registrierungen. Weitere Installationswege erklären den macOS-Download, den Bau aus dem Quellcode und die manuelle Konfiguration.

Probiere deine erste Erinnerung aus

1. Sage deinem Assistenten: „Merke dir: Erkläre Änderungen in diesem Projekt kurz und nenne, wie du sie geprüft hast.“
2. Lass dir die gespeicherte Erinnerung zeigen, damit du die Formulierung prüfen kannst.
3. Starte eine neue Sitzung und frage: „Welche Vorlieben habe ich bei der Erklärung von Änderungen in diesem Projekt?“

Wiederhole die Abfrage bei Bedarf in einem anderen verbundenen Client mit demselben Vault. So prüfst du einfach, ob deine Tools dieselbe Erinnerung nutzen. Unterstützte Hooks helfen außerdem, passenden Kontext während der normalen Arbeit einzublenden.

Unterstützte Oberflächen

Weitere MCP-Clients können den Forwarder verwenden, sind aber ungetestet. Skripte und andere Integrationen nutzen die REST-API. MCP ist das Protokoll, mit dem ein KI-Assistent externe Werkzeuge wie diesen Gedächtnisdienst verwendet.

Unterstützte Plattformen

Warum

Eine Projektentscheidung vom Montag soll am Donnerstag noch verfügbar sein, auch wenn du das KI-Tool wechselst. Bastra Recall gibt deinen Tools eine gemeinsame Anlaufstelle:

• Nützlichen Kontext bewahren: Vorlieben, Entscheidungen, Projektwissen und Erkenntnisse aus gelösten Problemen.
• Vor der Arbeit erinnern: Unterstützte Hooks liefern Kontext beim Sitzungsstart und vor Aktionen; der gemeinsame Skill leitet die eigenen Such- und Speichervorgänge des Assistenten an.
• Die Dateien behalten: Erinnerungen sind Markdown mit strukturierten Metadaten und außerhalb von Bastra lesbar und bearbeitbar.
• Gespeichertes nachvollziehen: bastra map öffnet die lokale Vault-Map zum Stöbern, Suchen und Pflegen.

Beispiele aus einer Arbeitswoche zeigen das Zusammenspiel.

Datenschutz und Kontrolle

Speicherung und Stichwortsuche laufen lokal. Ruft dein Assistent eine Erinnerung ab, erhält er deren Inhalt als Kontext; ein cloudbasierter Assistent kann ihn bei seinem Anbieter verarbeiten. Lokale Speicherung macht die gesamte KI-Sitzung nicht offline.

Semantische Suche ist optional. bastra embeddings on richtet lokale Ollama-Embeddings ein; bastra embeddings off schaltet zurück auf Stichwortsuche. Wenn du ausdrücklich OpenAI-Embeddings wählst, gehen Suchanfragen und indizierte Erinnerungstexte an OpenAI. Datenschutz und Netzwerkzugriffe erläutert diese Wege, Datei-Sync und optionale Netzwerkfunktionen.

Ein Vault in iCloud, Google Drive oder Dropbox nutzt die Synchronisierung dieses Dienstes. Gleichzeitige Änderungen auf mehreren Rechnern können Konflikte verursachen, auch mit Bastras automatischen Metadaten-Updates. Bastra bietet keinen verwalteten Mehrgeräte-Sync. Bewahre Backups auf und prüfe Konfliktkopien, bevor du Dateien ersetzt.

Anleitungen

• Vorhandene Erinnerungen importieren – Listen, Chat-Exporte, Regeln und Memory-Ordner. Ordnerimporte landen direkt in einem getrennten Bereich; die anderen Wege bereiten Kandidaten zur Prüfung vor.
• Vault-Map – Erinnerungen erkunden, suchen und zur Pflege markieren.
• Updates – mit bastra update aktualisieren oder automatische Updates aktivieren.
• Produkt-Dokumentation – Anleitungen deiner Projekte vom Assistenten pflegen lassen.
• Bastra Commons – optionale Community-Rezepte mit Prüfnachweisen.
• Nutzung und Fehlerbehebung · Memory-Format · Architektur · Hooks · Speicher- und Abrufauslöser · Taxonomie · Valenz und Reflex

Roadmap

Version 1.0 konzentriert sich auf gemessene Abrufqualität, passenden Sitzungskontext und klarere Kontrolle über die Gedächtnisnutzung. Das kumulative Kontextbudget einer Sitzung wird im Shadow-Modus gemessen; es erzwingt noch keine globale Obergrenze. Roadmap und Release-Grenzen.

Eine native Bastra-Mac-App ist in Entwicklung. Das Open-Source-Paket enthält bereits die lokale browserbasierte Vault-Map und funktioniert unabhängig von dieser App.

Lizenz und Kontakt

MIT – siehe LICENSE. Die Statusline enthält owloops/claude-powerline unter seiner beibehaltenen MIT-Lizenz.

Frage stellen · Fehler melden · Mitmachen · Projekt unterstützen. Sicherheitsprobleme bitte vertraulich über SECURITY.md melden.

Gebaut von Daniel / @n0mad-ai.