终端接口

你的记忆，可以编程

一个小小的命令，把你的 Overlay 记忆带进终端——也交到在终端里工作的编程智能体手中。在脚本、管道和 CLAUDE.md 里上传、下载、搜索。

安装

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

GitHub npm

01命令

五个动词，管道友好

给人看的输出是一本安静的账本——编号行，没有 UUID。--json 是机器契约：数据走 stdout，消息走 stderr，退出码诚实可靠。

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

02给编程智能体

把记忆交给 Claude Code

住在终端里的智能体也能用这五个动词。把这段贴进项目的 CLAUDE.md 或 AGENTS.md——智能体会先自己想起你过去的决定，而不是让你重新解释，并把学到的存回你的记忆。

## 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`.

03授权一次，随时可撤

overlay login 在浏览器里经你明确点击后，才把令牌交给这台机器。它存放在 ~/.config/overlay，会自动续期，overlay logout 即可撤销。你的账户，你的记忆，你的凭据。