터미널 인터페이스

당신의 기억을, 스크립트로

작은 명령 하나로 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으로 회수됩니다. 당신의 계정, 당신의 기억, 당신의 근거.