Die Terminal-Schnittstelle

Dein Gedächtnis, skriptfähig

Ein kleiner Befehl bringt dein Overlay-Gedächtnis ins Terminal – und in die Hände der Coding-Agenten, die dort arbeiten. Hochladen, herunterladen und durchsuchen aus Skripten, Pipes und CLAUDE.md.

Installieren

npm i -g @overlay-one/cli
overlay login        # one browser click

GitHub npm

01Die Befehle

Fünf Verben, pipe-freundlich

Die Ausgabe für Menschen ist ein ruhiges Journal – nummerierte Zeilen, keine UUIDs. --json ist der Maschinenvertrag: Daten auf stdout, Meldungen auf stderr, ehrliche Exit-Codes.

overlay upload paper.pdf               # into your memory
cat notes.md | overlay upload - --name notes.md
overlay search "prompt caching"        # hybrid search over everything
overlay files                          # recent sources
overlay download 2 --annotated         # row 2; PDFs keep your highlights

02Für Coding-Agenten

Gib Claude Code dein Gedächtnis

Agenten, die im Terminal leben, nutzen dieselben fünf Verben. Füge das in die CLAUDE.md oder AGENTS.md deines Projekts ein – der Agent ruft deine früheren Entscheidungen ab, statt dich neu erklären zu lassen, und legt Gelerntes zurück in dein Gedächtnis.

## Memory — Overlay CLI

This machine is authorized against my personal memory (overlay.one).
Use it instead of asking me to re-explain past work.

- Recall context first:  overlay search "<topic>" --json
- List recent sources:   overlay files --json
- Read a stored file:    overlay download <id or row #> -o /tmp/<name>
- Save what you learn:   overlay upload <file>
  (or pipe: echo "decision: ..." | overlay upload - --name decision.md)

Contract: --json prints raw API payloads on stdout; messages go to
stderr; exit code 3 means run `overlay login`.

03Einmal autorisiert, jederzeit widerrufbar

overlay login übergibt dieser Maschine nach einem expliziten Klick im Browser ein Token. Es liegt in ~/.config/overlay, erneuert sich selbst, und overlay logout widerruft es. Dein Konto, dein Gedächtnis, deine Belege.