Erste Schritte

Für OpenCode v2 das Paket zur nativen plugins-Liste hinzufügen:

{
  "plugins": ["opencode-mem@latest"],
}

OpenCode lädt den ./tui-Companion des Pakets automatisch, damit Auto-Capture- / Profil- / Fehler-Toasts in der TUI erscheinen (Server-Plugins können ui.toast nicht direkt aufrufen). Du brauchst keinen zweiten Eintrag in plugins. Wenn du eine reine CLI-TUI gegen einen Remote-OpenCode-Server betreibst, registriere opencode-mem/tui in der Plugin-Liste dieser CLI (z. B. cli.json), damit der Companion Toast-RPC-Events abonnieren kann.

Für OpenCode v1 den Standard-Entrypoint in der Konfiguration unter ~/.config/opencode/opencode.json hinzufügen:

{
  "plugin": ["opencode-mem@latest"],
}

Mit @latest (oder einem Semver-Bereich) und autoUpdate: true in opencode-mem.jsonc (Standard) löscht das Plugin den von OpenCode zwischengespeicherten Install, sobald eine neuere npm-Version verfügbar ist, und bittet dich um einen Neustart. Gepinnte Versionen wie opencode-mem@2.26.0 werden nie automatisch aktualisiert.

Automatischer Speicher-Kontext unter OpenCode v2

Das v2-Plugin liefert automatischen Speicher-Kontext über den Systemkontext des Modells. Diese Blöcke werden nicht zum verfassten User-Prompt hinzugefügt und nicht im Chat-Transkript gespeichert. Mit chatMessage.injectOn: "first" (der Standard) bleibt der initiale Kontext der Sitzung über User-Turns und Modell-Schritte erhalten. Mit "always" wird er bei jedem verfassten User-Turn aktualisiert.

Nach einem Host- oder Plugin-Neustart baut eine fortgesetzte Sitzung ihren Kontext beim nächsten Modell-Request aus dem aktuellen Speicher neu auf, auch wenn kein neuer User-Prompt eintrifft. Der neu aufgebaute Kontext kann vom Original abweichen, da sich Memories und Profil weiterentwickeln. Die Wiederherstellung erzeugt keinen synthetischen User-Prompt und speichert keine zweite Kopie des Speichertexts im OpenCode-Plugin-Storage. Compaction invalidiert den zwischengespeicherten automatischen Kontext; die bestehende Compaction-Memory-Wiederherstellung läuft weiterhin.