01Los comandos
Cinco verbos, amigos de las pipes
La salida humana es un libro de registro sereno: filas numeradas, sin UUIDs. --json es el contrato para máquinas: datos en stdout, mensajes en stderr, códigos de salida honestos.
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
02Para agentes de código
Dale tu memoria a Claude Code
Los agentes que viven en la terminal pueden usar los mismos cinco verbos. Pega esto en el CLAUDE.md o AGENTS.md de tu proyecto: el agente recordará tus decisiones pasadas antes de pedirte que las expliques de nuevo, y archivará lo que aprenda en tu memoria.
## 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`.
03Autorizado una vez, revocable siempre
overlay login entrega un token a esta máquina tras un clic explícito en tu navegador. Vive en ~/.config/overlay, se renueva solo y overlay logout lo revoca. Tu cuenta, tu memoria, tus comprobantes.