Repository navigation
Privacy
Bastra Recall stores memories as files in your chosen vault. Keyword search runs locally. This describes the memory service, not every system connected to it.
| Data path | What happens |
|---|---|
| AI assistant | Retrieved memories, document text and hook context are passed to the connected client. If that client uses a cloud model, its provider may process the content. Your client's settings and data policy apply. |
| Local embeddings | Optional Ollama embeddings process queries and memory text locally with a local endpoint. Deliberately allowing a remote Ollama endpoint changes that boundary. |
| OpenAI embeddings | Requires an explicit provider choice and credentials. Queries and indexed memory text are sent to api.openai.com. An unrelated OPENAI_API_KEY alone does not select this provider in the v1.0 implementation. |
| Importing chat exports | The import queue is stored locally. When you ask your assistant to extract memories, it reads chunks of that queue; a cloud-based assistant may process those chunks remotely. bastra import clear discards the queue. |
| File synchronization | A vault in iCloud, Google Drive, Dropbox or a Git remote uses that service. Choose its access and backup settings yourself. Concurrent file edits can conflict. |
| REST access | The service normally listens on your computer. If you expose it through a tunnel or connect another application, that application can receive the data allowed by the API. Follow the REST setup. |
| Bastra Commons | Optional downloads of community recipes. Sharing a contribution is a separate, reviewed action; enabling Commons does not publish your private vault. See Commons. |
- Installation and model setup download software and models from the selected distribution services.
- Update detection checks GitHub for releases.
BASTRA_UPDATE_CHECK=offdisables the update check. - The statusline can refresh model pricing information.
- Optional map weather/geocoding sends a coarse location after you choose a place. It does not need memory contents.
These requests are distinct from uploading a vault. Local telemetry records activity and timings; the map's telemetry view reads local logs. Before sharing logs or a bug report, check for personal information, tokens and private paths.
One local file can hold text you typed and excerpts of your notes: training-capture.jsonl in the log directory. It is written only when BASTRA_TRAINING_CAPTURE is enabled (1, true, on or yes), which is off by default; it is a temporary local capture option and is never sent anywhere. See training signal capture.
While the after-session harvest is enabled and sessions are booked by its hooks, it captures typed user messages that pass the noise filter, have at least 20 letters and fewer than 2,000 characters. Injected turns, interruptions and large pastes are excluded. At harvest time, a separate word-based check skips quotes already covered by stored vault wording. A later save call in the transcript does not itself suppress capture; the note it actually saved can still make that separate vault check match. Drafts remain unconfirmed quotes, separate from vault notes.
Where available in the client transcript, a draft also keeps up to three earlier
and three following assistant shell commands, up to three previously read file
paths, working directory, project and branch. These fields use the same redaction
heuristic as the quote. Session/turn/time evidence and later delivery/use evidence
are recorded too. The optional context field is an excerpt of the assistant
question the message answers (its last line, at most 160 characters).
The default local files are:
-
~/.bastra/drafts.json: quotes, context, situation and evidence; permissions 0600. -
~/.bastra/drafts.vectors.json: model-bound local vectors and hash metadata; permissions 0600. -
~/.bastra/drafts.json.decisions.json: hash-only decision receipts, no quotes; permissions 0600. -
~/.bastra/pending-suggestions.json: the shared suggestion relay, with redacted text; ordinary writes in the prepared 1.1 release use 0600. Legacy rows are redacted before delivery and on their next ordinary write. -
~/.bastra/harvest-queue.json: session/transcript paths and harvest progress, not quotes. This is separate from the draft store and is not deleted by draft purge.
New draft-store writes use 0600. An existing draft store with broader permissions is tightened on its next write; reading alone does not change its permissions.
BASTRA_DRAFTS_PATH relocates the draft store and its vector/decision sidecars;
BASTRA_PENDING_SUGGESTIONS_PATH and BASTRA_HARVEST_QUEUE_PATH can relocate the
relay and queue. Normal harvest relay entries are consumed at the next session
start; entries older than seven days are dropped on that read. The same relay
also holds trends, which retire by counted sessions and can last longer.
Without another read, old relay rows can remain on disk.
Recognizable credentials are redacted before storage; useful paths and variable references remain. The filter is a heuristic with known limits: word-only passwords in ordinary prose and unsupported forms can remain visible. It does not repair the original client transcript, old vault notes or backups. Quotes are clipped to 600 characters and context to 160; the store holds at most 500 rows and 1 MiB, so its limits can evict rows earlier.
Open drafts with one evidence row and no valid use proof expire after 7 days; other open drafts after 30 days, closed/rejected/promotion records after 180 days, measured from their last touch. Active harvest ticks and ordinary store writes remove expired rows. If that work is disabled, old data can remain on disk. Draft telemetry contains IDs, counts and metrics, not the captured quote.
Capture, draft embeddings and meaning checks run locally, without uploading
these local files. The meaning check can call a local model even in the default
dry run. Without exactly BASTRA_DRAFT_PROMOTE=1, automatic draft promotion
writes no vault note. Text can reach the connected assistant through the
unconfirmed band at prompts, session starts and before tool calls; through
draft_hits in the MCP recall result; and through the pending relay at the
next session start. A cloud-based assistant may process those texts remotely
under its own policy. After opt-in promotion, the derived note is ordinary vault
content: it can be retrieved by connected clients and processed by the chosen
vault embedding provider, including a non-local provider. That provider path
is separate from the assistant; draft embeddings themselves remain local.
Busy relay reads are skipped immediately and retain their entries for the next start. Stop-hook writes skip contention on the response path and are retried in the daemon background under a real lock, without normal busy-lock warnings. The in-memory deferred write can be lost if the daemon is killed before it is persisted; this is not a second durable queue.
At SessionStart, Claude Code and Codex can receive a separate <draft-review>
block with up to three open drafts evaluated locally as would_promote or
would_block. Review and old relay content share the existing 3,000-character
budget: review is first, the old block receives what remains (plus its fixed
frame and truncation notice). The review block includes the
secret-redacted quote, project, date and available local verdicts. Only drafts
with confirmed provenance for the current vault and a candidate verdict from
the latest completed local pass are eligible. A later pass removes obsolete
verdicts or replaces changed verdicts; shown and answered markers stay. Injection findings
exclude the whole candidate; quoted text is untrusted data, never instructions.
Each draft is presented once per vault while its record is retained. If more
candidates fit later, they wait for another start. Busy or inaccessible stores
are skipped rather than blocking the session. Presentation is a durable claim
when the hook response is prepared, not proof that the agent read it.
confirm only if the statement is correct, durable beyond that session and not already in the vault. confirm saves nothing; if worth saving, save it yourself with save_memory as usual. reject if it is false, outdated, a one-off request, or already in the vault. If unsure and the question fits the current task, briefly ask the user once, in one sentence including the quote, then send confirm or reject based on their answer. Do not guess or repeat the question. If the user is busy with another task or does not answer, leave the draft unanswered to expire normally.
The agent should recall first and check three things: is it correct, is it
durable, does the vault already hold it? Answer with MCP review_draft, passing
id and decision: "confirm" or decision: "reject". The write/full tool
surfaces expose it; the search-only surface does not. Confirmation records only
an agent verdict on the draft. It never saves a note, starts promotion or adds
a promotion gate. Rejection closes the draft with the retained fingerprint
that blocks an identical recapture. Repeated identical answers are idempotent.
Already promoted drafts cannot be rejected with this tool; use the existing
undo workflow for those. A confirmation is evidence, not proof.
The old sentence-quote block remains enabled. A quote shown in the new block is
removed only from the old harvest block in that same SessionStart; other old
quotes remain eligible within the shared budget. The independent recall hint band keeps its existing rules.
The new block is off if any of BASTRA_PENDING_RELAY=0,
BASTRA_SESSION_HARVEST=0 or BASTRA_DRAFT_HINTS=0 is set in the daemon's
environment (restart after changes); retained candidates stay unread by this
presentation path. Verdict capture and explicit answers can still update draft
metadata. drafts purge clears these records together with the other stores.
Review verdicts, the shown-vault marker and the answer use optional fields in the existing draft file, without a schema migration. Local evaluation receipts are refreshed once to attach candidate metadata; cached local model verdicts remain reusable. Review metadata does not invalidate promotion decisions. Shown/confirmed/rejected telemetry contains draft IDs and counts, never quotes. The redacted quote reaches the session's assistant, including its cloud provider when applicable. Redaction is heuristic and has the documented limits.
An agent's separate save_memory does not directly close the draft. In the
standard dry run, even a subsequent existing-note duplicate check keeps it open;
only the existing sharp-mode duplicate path can close it when all its gates
pass. No additional closing logic was added. Automatic promotion remains off
by default; neither sharp-mode confirmation gating nor retirement of the old
quote block is part of steps 1–2.
Set the switches in the daemon's environment and restart it; changing only
a CLI shell does not alter a running daemon. Off values are 0, false, off
and no, case-insensitive with surrounding whitespace ignored.
-
BASTRA_SESSION_HARVEST=0stops booking/capture, the harvest tick, shadow comparisons, automatic promotion and new harvest relay writes. Existing draft hints still work unless hints are also disabled. -
BASTRA_DRAFT_HINTS=0stops the unconfirmed hint band,draft_hitsand use tracking. It does not stop capture or relay writes/delivery. -
BASTRA_PENDING_RELAY=0stops every relay writer and SessionStart delivery, including Stop, curator and harvest. The existing file is left in place and is not read while disabled. Capture and the draft hint band are separate.
For draft capture and hints to stay off, set both draft switches; add
BASTRA_PENDING_RELAY=0 to stop shared relay writes and delivery as well.
bastra drafts list inspects the store. bastra drafts purge removes the draft
store, vectors and decision receipts, and clears the pending relay to an empty
0600 file under its usual lock, even when relay delivery is disabled. The relay is validated first, then drafts are deleted, then the relay is cleared.
An unreadable or malformed relay is preserved and the command fails before
deleting drafts; an empty relay is accepted. Failed draft deletion leaves the
relay unchanged.
The command reports the cleared stores and marks an absent relay as not present; it does not clear the harvest queue,
optional training capture or already promoted vault notes. Stop capture before
clearing to prevent new entries. The harvest queue can resume queued sessions
when harvest is reenabled; its session/path metadata is retained.
On an existing Claude Code installation,
bastra install claude-code --no-stop-hook preserves a previously enabled Stop
hook and its SessionEnd companion; it does not remove them. Disable/remove those
entries explicitly in the client's hook configuration when needed.
The optional training store has its own retained data.
The suggestion relay keeps earlier session excerpts in
~/.bastra/pending-suggestions.json, outside the vault, with permissions 0600.
It removes recognizable credentials with the same heuristic as local drafts
before writing or delivering the text to your assistant. Existing rows are
cleaned on their next ordinary write and before delivery, without a migration.
An unreadable or malformed existing relay is left untouched: the new write is
skipped with a warning that contains no excerpts or paths. A missing file is
created normally.
Recency entries are consumed at the next session start; entries older than
seven days are dropped on that read. Trends retire by their configured session
counter; their tombstones remain for that many further counted starts unless
refreshed. Without further reads, rows can remain on disk. The heuristic has known limits.
Inspect and edit the Markdown files directly, or use the memory tools through your assistant. Use bastra embeddings off for keyword-only search and bastra embeddings on to set up local embeddings. Removing client registrations with bastra uninstall all keeps your vault; uninstalling the package is a separate step.
The sensitivity field filters access through specific Bastra interfaces. It is not file encryption or a substitute for operating-system permissions. See the memory schema. Report suspected vulnerabilities through SECURITY.md.
This page includes the changes prepared for 1.1.0. Check the changelog for version-specific changes.
Bastra Recall speichert Erinnerungen als Dateien in deinem gewählten Vault. Die Stichwortsuche läuft lokal. Das beschreibt den Gedächtnisdienst, nicht jedes damit verbundene System.
| Datenweg | Was passiert |
|---|---|
| KI-Assistent | Abgerufene Erinnerungen, Dokumenttexte und Hook-Kontext werden dem verbundenen Client übergeben. Nutzt er ein Cloud-Modell, kann dessen Anbieter die Inhalte verarbeiten. Es gelten die Einstellungen und Datenschutzbedingungen deines Clients. |
| Lokale Embeddings | Optionale Ollama-Embeddings verarbeiten Anfragen und Erinnerungstexte mit einem lokalen Endpunkt auf deinem Rechner. Wenn du bewusst einen entfernten Ollama-Endpunkt erlaubst, ändert sich diese Grenze. |
| OpenAI-Embeddings | Erfordern die ausdrückliche Provider-Wahl und Zugangsdaten. Suchanfragen und indizierte Erinnerungstexte gehen an api.openai.com. Ein anderweitig gesetzter OPENAI_API_KEY allein wählt diesen Provider in der v1.0-Implementierung nicht aus. |
| Chat-Exporte importieren | Die Import-Warteschlange liegt lokal. Wenn du deinen Assistenten Erinnerungen daraus extrahieren lässt, liest er Abschnitte dieser Warteschlange; ein cloudbasierter Assistent kann sie beim Anbieter verarbeiten. bastra import clear verwirft die Warteschlange. |
| Datei-Synchronisierung | Ein Vault in iCloud, Google Drive, Dropbox oder einem Git-Remote nutzt diesen Dienst. Zugriff und Backups bestimmst du selbst. Gleichzeitige Dateiänderungen können Konflikte verursachen. |
| REST-Zugriff | Der Dienst lauscht normalerweise auf deinem Rechner. Wenn du ihn durch einen Tunnel erreichbar machst oder eine weitere Anwendung verbindest, kann sie die von der API erlaubten Daten erhalten. Siehe REST-Einrichtung. |
| Bastra Commons | Optionaler Download von Community-Rezepten. Das Teilen eines Beitrags ist eine separate, geprüfte Aktion; die Aktivierung veröffentlicht deinen privaten Vault nicht. Siehe Commons. |
- Installation und Modelleinrichtung laden Software und Modelle von den gewählten Bezugsquellen herunter.
- Die Update-Erkennung fragt GitHub nach Releases.
BASTRA_UPDATE_CHECK=offdeaktiviert diese Prüfung. - Die Statusline kann Modellpreise aktualisieren.
- Die optionale Wetter-/Geocoding-Funktion der Map sendet nach deiner Ortswahl einen groben Standort. Sie benötigt keine Erinnerungsinhalte.
Diese Anfragen sind vom Hochladen eines Vaults zu unterscheiden. Lokale Telemetrie zeichnet Aktivitäten und Laufzeiten auf; die Telemetrieansicht der Map liest lokale Logs. Prüfe Logs und Fehlerberichte vor dem Teilen auf persönliche Angaben, Tokens und private Pfade.
Eine lokale Datei kann Text enthalten, den du getippt hast, und Auszüge deiner Notizen: training-capture.jsonl im Protokollverzeichnis. Sie wird nur geschrieben, wenn BASTRA_TRAINING_CAPTURE eingeschaltet ist (1, true, on oder yes), und das ist standardmäßig aus; sie ist eine befristete lokale Aufzeichnungsoption und wird nirgendwohin gesendet. Siehe Trainingssignal mitschreiben.
Solange der nachträgliche Sitzungs-Harvest eingeschaltet ist und seine Hooks Sitzungen vormerken, erfasst er getippte Nutzernachrichten hinter dem Rauschfilter mit mindestens 20 Buchstaben und weniger als 2.000 Zeichen. Eingespielte Turns, Abbrüche und große eingefügte Texte fallen weg. Beim Harvest überspringt ein separater wortbasierter Abgleich Zitate, deren Formulierung der Vault bereits abdeckt. Ein späterer Speicheraufruf im Transcript unterdrückt die Erfassung nicht allein; die dabei tatsächlich gespeicherte Notiz kann aber den separaten Vault-Abgleich erfüllen. Entwürfe bleiben unbestätigte Zitate, getrennt von Vault-Notizen.
Soweit im Client-Transcript vorhanden, hält ein Entwurf auch bis zu drei vorherige
und drei folgende Shell-Befehle des Assistenten, bis zu drei zuvor gelesene
Dateipfade, Arbeitsverzeichnis, Projekt und Branch. Für diese Felder gilt dieselbe
Schwärz-Heuristik wie für das Zitat. Hinzu kommen Sitzungs-/Turn-/Zeitbelege und
spätere Anzeige-/Nutzungsbelege. Das optionale Feld context enthält einen
Ausschnitt der Assistenten-Frage, auf die die Nachricht antwortet (deren letzte
Zeile, höchstens 160 Zeichen).
Die lokalen Standarddateien sind:
-
~/.bastra/drafts.json: Zitate, Kontext, Situation und Belege; Rechte 0600. -
~/.bastra/drafts.vectors.json: modellgebundene lokale Vektoren und Hash-Metadaten; Rechte 0600. -
~/.bastra/drafts.json.decisions.json: Entscheidungsmerker nur als Hashes, keine Zitate; Rechte 0600. -
~/.bastra/pending-suggestions.json: der gemeinsame Vorschlags-Relay mit geschwärztem Text; normale Schreibvorgänge des vorbereiteten 1.1-Releases verwenden 0600. Alte Zeilen werden vor der Auslieferung und beim nächsten normalen Schreiben geschwärzt. -
~/.bastra/harvest-queue.json: Sitzungs-/Transcript-Pfade und Harvest-Fortschritt, keine Zitate. Diese Datei liegt getrennt von der Entwurfsablage und wird durch draft purge nicht gelöscht.
Neue Schreibvorgänge in der Entwurfsablage verwenden 0600. Eine vorhandene Entwurfsablage mit weiter gefassten Rechten wird beim nächsten Schreibzugriff auf 0600 begrenzt; reines Lesen ändert ihre Rechte nicht.
BASTRA_DRAFTS_PATH verlegt die Entwurfsablage samt Vektor-/Entscheidungsdateien;
BASTRA_PENDING_SUGGESTIONS_PATH und BASTRA_HARVEST_QUEUE_PATH können Relay und
Queue verlegen. Normale Harvest-Relay-Einträge werden beim nächsten Sitzungsstart
konsumiert; Einträge über sieben Tage werden bei dieser Lesung verworfen.
Derselbe Relay hält auch Trends, die nach gezählten Sitzungen stillgelegt werden
und länger bleiben können. Ohne weitere Lesung können alte Relay-Zeilen auf der
Platte bleiben.
Erkennbare Zugangsdaten werden vor dem Speichern geschwärzt; nützliche Pfade und Variablenreferenzen bleiben erhalten. Der Filter ist eine Heuristik mit bekannten Grenzen: Passwörter nur aus Wörtern in gewöhnlicher Prosa und nicht unterstützte Formen können lesbar bleiben. Er repariert weder das ursprüngliche Client-Transcript noch alte Vault-Notizen oder Backups. Zitate werden auf 600 Zeichen und Kontext auf 160 gekürzt; die Ablage hält höchstens 500 Zeilen und 1 MiB, sodass diese Grenzen Zeilen früher verdrängen können.
Offene Entwürfe mit einem Beleg ohne gültigen Nutzungsnachweis verfallen nach 7 Tagen, andere offene nach 30 Tagen, geschlossene/abgelehnte/Beförderungs- Datensätze nach 180 Tagen, gerechnet ab der letzten Berührung. Aktive Harvest- Ticks und normale Ablage-Schreibvorgänge entfernen verfallene Zeilen. Ist diese Arbeit abgeschaltet, können alte Daten auf der Platte bleiben. Die Entwurfs- Telemetrie enthält IDs, Zähler und Messwerte, nicht das erfasste Zitat.
Erfassung, Entwurfs-Embeddings und Bedeutungsprüfungen laufen lokal, ohne diese
lokalen Dateien hochzuladen. Die Bedeutungsprüfung kann auch im standardmäßigen
Probelauf ein lokales Modell aufrufen. Ohne exakt BASTRA_DRAFT_PROMOTE=1 schreibt
die automatische Übernahme keine Vault-Notiz. Text kann den verbundenen Assistenten
über das unbestätigte Band bei Prompts, Sitzungsstarts und vor Werkzeugaufrufen,
über draft_hits im Ergebnis des MCP-Werkzeugs recall und über den Pending-Relay
beim nächsten Sitzungsstart erreichen. Ein cloudbasierter Assistent kann diese
Texte nach seinen eigenen Regeln beim Anbieter verarbeiten. Nach eingeschalteter
Übernahme ist die abgeleitete Notiz normaler Vault-Inhalt: Verbundene Clients
können sie abrufen, und der gewählte Vault-Embedding-Anbieter kann sie verarbeiten,
auch ein nicht-lokaler Anbieter. Dieser Anbieterweg läuft getrennt vom Assistenten;
die Embeddings der Entwürfe selbst bleiben lokal.
Belegte Relay-Sperren werden beim Lesen sofort übersprungen; die Einträge bleiben für den nächsten Start. Stop-Hook-Schreibvorgänge warten auf dem Antwortweg nicht auf die Sperre und werden im Daemon-Hintergrund unter einer echten Sperre wiederholt, ohne Störmeldung bei normaler Belegung. Ein noch nicht gespeicherter Auftrag im Arbeitsspeicher kann bei einem harten Daemon-Abbruch verloren gehen; das ist keine zweite dauerhafte Warteschlange.
Bei SessionStart können Claude Code und Codex einen eigenen <draft-review>-
Block mit höchstens drei offenen Entwürfen erhalten, die lokal als
would_promote oder would_block beurteilt wurden. Review und alter Relay-Inhalt
teilen das vorhandene Budget von 3.000 Zeichen: zuerst Review, der alte Block
bekommt den Rest (zuzüglich seines festen Rahmens und Kürzungshinweises).
Der Review-Block enthält geschwärztes Zitat, Projekt, Datum und vorhandene
lokale Urteile. Nur Entwürfe mit bestätigter Herkunft für den aktuellen Vault
und Kandidatenurteil aus dem letzten vollständig abgeschlossenen lokalen Pass
kommen infrage. Ein späterer Pass entfernt überholte Vermerke oder ersetzt
geänderte Urteile; Gezeigt- und Antwortvermerke bleiben erhalten. Ein Injection-Fund schließt den ganzen Kandidaten aus;
Zitattext ist unbestätigtes Material, keine Anweisung. Jeder Entwurf wird je
Vault einmal vorgelegt, solange sein Datensatz erhalten bleibt. Weitere
Kandidaten warten auf einen späteren Start. Eine belegte oder unzugängliche
Ablage wird übersprungen, statt den Sitzungsstart aufzuhalten. „Vorgelegt“ ist
ein dauerhafter Vermerk beim Vorbereiten der Hook-Antwort, kein Lesebeweis.
confirm nur, wenn die Aussage stimmt, über die damalige Sitzung hinaus gilt und noch nicht im Vault steht. confirm speichert nichts; falls speichernswert, speichere selbst wie gewohnt mit save_memory. reject, wenn sie falsch oder überholt ist, ein einmaliger Auftrag war oder schon im Vault steht. Bei Unsicherheit, wenn die Frage gerade passt, den Nutzer einmal kurz in einem Satz mit dem Zitat fragen und nach seiner Antwort confirm oder reject senden. Nicht raten oder die Frage wiederholen. Passt die Frage gerade nicht, weil der Nutzer mit einer anderen Aufgabe beschäftigt ist, oder antwortet er nicht, bleibt der Entwurf unbeantwortet und verfällt regulär.
Der Agent soll zuerst Recall nutzen und drei Fragen prüfen: Stimmt das? Ist es
dauerhaft? Hat der Vault es schon? Er antwortet über MCP review_draft mit id
und decision: "confirm" oder decision: "reject". Die Werkzeugoberflächen
write/full bieten den Aufruf, die reine Suchoberfläche nicht. Bestätigen hält
nur das Agentenurteil am Entwurf fest. Es speichert keine Notiz, startet keine
Übernahme und fügt keine Übernahmesperre hinzu. Ablehnen schließt den Entwurf
mit dem vorhandenen Fingerprint-Sperrvermerk gegen identische Neuerfassung.
Gleiche Antworten sind wiederholbar, ohne doppelte Wirkung. Bereits beförderte
Entwürfe lassen sich hier nicht ablehnen; dafür bleibt der vorhandene
Undo-Ablauf. Eine Bestätigung ist ein Indiz, kein Beweis.
Der alte Satz-Zitat-Block bleibt an. Ein im neuen Block gezeigtes Zitat entfällt
nur im alten Harvest-Block desselben SessionStart; andere alte Zitate bleiben im gemeinsamen Budget zulässig.
Das unabhängige Recall-Hinweisband behält seine bisherigen Regeln. Der neue
Block ist aus, sobald einer von BASTRA_PENDING_RELAY=0,
BASTRA_SESSION_HARVEST=0 oder BASTRA_DRAFT_HINTS=0 in der Daemon-Umgebung
steht (nach Änderungen neustarten). Aufbewahrte Kandidaten werden durch diesen
Vorlageweg nicht gelesen. Lokale Urteile und ausdrückliche Antworten können
weiter Entwurfsmetadaten aktualisieren. drafts purge leert diese Datensätze
mit den anderen Ablagen.
Lokale Urteile, der Vorlagevermerk je Vault und die Antwort nutzen Zusatzfelder in der vorhandenen Entwurfsdatei, ohne Schema-Migration. Lokale Prüfmerker werden einmal erneuert, um Kandidatenmetadaten anzuhängen; zwischengespeicherte lokale Modellurteile bleiben verwendbar. Review-Metadaten machen Übernahmeentscheidungen nicht ungültig. Telemetrie für gezeigt/bestätigt/abgelehnt enthält Entwurfs-IDs und Zähler, keine Zitate. Das geschwärzte Zitat erreicht den Sitzungsassistenten und gegebenenfalls dessen Cloud-Anbieter. Die Schwärzung ist eine Heuristik mit den dokumentierten Grenzen.
Ein gesondertes save_memory des Agenten schließt den Entwurf nicht direkt.
Im standardmäßigen Probelauf hält ihn auch die spätere bestehende
Dublettenprüfung offen. Nur der vorhandene scharfe Dublettenweg kann ihn bei
erfüllten Sperren schließen. Keine zusätzliche Schließlogik wurde gebaut.
Automatische Übernahme bleibt standardmäßig aus; eine Bestätigungssperre im
scharfen Modus und das Abschalten des alten Zitatblocks gehören nicht zu den
Schritten 1–2.
Die Schalter in der Umgebung des Daemons setzen und ihn neustarten;
eine Änderung nur in einer CLI-Shell verändert den laufenden Daemon nicht.
Aus-Werte sind 0, false, off und no, ohne Beachtung der Groß-/Kleinschreibung
und mit ignorierten umgebenden Leerzeichen.
-
BASTRA_SESSION_HARVEST=0stoppt Vormerken/Erfassung, den Harvest-Tick, Shadow-Vergleiche, automatische Übernahme und neue Harvest-Relay-Schreibvorgänge. Bestehende Entwurfs-Hinweise funktionieren weiter, solange die Hinweise nicht ebenfalls abgeschaltet sind. -
BASTRA_DRAFT_HINTS=0stoppt das unbestätigte Hinweisband,draft_hitsund die Nutzungserfassung. Erfassung sowie Relay-Schreiben/-Auslieferung bleiben davon unberührt. -
BASTRA_PENDING_RELAY=0stoppt alle Relay-Schreiber und die SessionStart-Auslieferung, auch Stop, Curator und Harvest. Die vorhandene Datei bleibt liegen und wird bei abgeschaltetem Relay nicht gelesen. Erfassung und Entwurfs-Hinweisband bleiben getrennt.
Damit Entwurfs-Erfassung und Hinweise aus bleiben, beide Entwurfs-Schalter
setzen; zusätzlich BASTRA_PENDING_RELAY=0 schaltet die gemeinsame Weitergabe
vollständig ab. bastra drafts list zeigt die Ablage. bastra drafts purge
entfernt Entwurfsablage, Vektoren und Entscheidungsmerker und leert den Relay
unter derselben Sperre in eine leere 0600-Datei, auch bei abgeschalteter
Weitergabe. Zuerst wird der Relay geprüft, dann werden Entwürfe gelöscht, danach wird der Relay
geleert. Ein unlesbarer oder beschädigter Relay bleibt erhalten; der Befehl
scheitert vor dem Löschen der Entwürfe. Eine leere Relay-Datei wird akzeptiert;
scheitert das Löschen der Entwürfe, bleibt der Relay unverändert. Die Ausgabe
nennt die geleerten Ablagen und kennzeichnet einen fehlenden Relay als nicht vorhanden.
Harvest-Queue, optionale Trainingsdaten und bereits beförderte Vault-Notizen
bleiben erhalten. Vor dem Leeren die Erfassung abschalten, damit keine neuen
Einträge entstehen. Die Harvest-Queue behält Sitzungs-/Pfadmetadaten und kann
nach erneutem Einschalten vorgemerkte Sitzungen fortsetzen. Bei einer bestehenden Claude-Code-
Installation erhält bastra install claude-code --no-stop-hook einen zuvor
aktivierten Stop-Hook und seinen SessionEnd-Begleiter; es entfernt sie nicht.
Diese Einträge bei Bedarf ausdrücklich in der Hook-Konfiguration des Clients
deaktivieren/entfernen. Die optionale Trainingsablage
hat ihren eigenen aufbewahrten Datenbestand.
Der Vorschlags-Relay hält Auszüge früherer Sitzungen außerhalb des Vaults in
~/.bastra/pending-suggestions.json, mit Rechten 0600. Vor dem Schreiben und der
Übergabe an deinen Assistenten entfernt er erkennbare Zugangsdaten mit derselben
Heuristik wie lokale Entwürfe. Alte Zeilen werden beim nächsten normalen
Schreiben und vor der Auslieferung geschwärzt, ohne Migration. Eine vorhandene,
aber unlesbare oder beschädigte Relay-Datei bleibt unverändert: Der neue
Schreibvorgang entfällt mit einer Warnung ohne Auszüge oder Pfade. Eine fehlende
Datei wird normal angelegt. Recency-Einträge
werden beim nächsten Session-Start konsumiert; dabei werden Einträge über sieben
Tage verworfen. Trends werden nach dem eingestellten Sitzungszähler stillgelegt;
ihre Tombstones bleiben für ebenso viele weitere gezählte Starts, solange sie
nicht aufgefrischt werden. Ohne weitere Lesungen können Zeilen auf der Platte
bleiben. Die Heuristik hat
bekannte Grenzen.
Prüfe und bearbeite Markdown-Dateien direkt oder nutze die Memory-Tools über deinen Assistenten. bastra embeddings off aktiviert reine Stichwortsuche; bastra embeddings on richtet lokale Embeddings ein. bastra uninstall all entfernt Client-Registrierungen und behält deinen Vault. Das Paket wird separat deinstalliert.
Das Feld sensitivity filtert den Zugriff über bestimmte Bastra-Schnittstellen. Es verschlüsselt keine Dateien und ersetzt keine Betriebssystemrechte. Siehe Memory-Schema. Vermutete Sicherheitslücken melde über SECURITY.md.
Diese Seite enthält die für 1.1.0 vorbereiteten Änderungen. Versionsspezifische Änderungen stehen im Changelog.
- Home
- Proactive Tasks
- System Requirements
- Claude Desktop
- Codex + ChatGPT Desktop
- Importing Memories
- Vault Map
- Privacy
- Updating
- Statusline
- Product Docs
- Bastra Commons
- How Recall Works
- Valence and Reflex
- Tools Reference
- Architecture
- Doctor
- Local Drafts
- Pending Relay
- Secret Redaction
- Model Recommendations
- Local Model Comparison
- Code Awareness
- Telemetry
- Training Capture
- Codex Save Notices
- Archiving and Git Snapshots
- Vault Reconciliation
- Battery Saver
- Derived Claims
- Learned Bridges
- Release Check
- Start
- Aufgaben: Opt-in-Vorschau
- Systemvoraussetzungen
- Claude Desktop
- Codex + ChatGPT Desktop
- Erinnerungen importieren
- Vault-Karte
- Datenschutz
- Aktualisieren
- Statusleiste und Panels
- Produktanleitungen
- Bastra Commons
- So funktioniert Recall
- Valenz und Reflex
- Werkzeugreferenz
- Architektur
- Einrichtung prüfen
- Lokale Entwürfe
- Weitergereichte Vorschläge
- Geheimnisse schwärzen
- Modell-Empfehlungen
- Ergebnisse lokaler Modelle
- Code-Abhängigkeiten
- Telemetrie
- Trainingsaufzeichnung
- Codex-Speicherhinweise
- Archivierung und Git-Schnappschüsse
- Vault-Kopien vergleichen
- Akkumodus
- Quellgebundene Aussagen
- Gelernte Wortverbindungen
- Release prüfen