rewind

name	rewind
description	Retrieve recent local Clips Rewind context when the user says "Look at Rewind," asks what just happened, or refers to something they recently said or saw.
metadata	{"visibility":"exported"}

Rewind

Use Clips Rewind as local screen memory. Start broad enough to find the right moment, then read only the smallest relevant range.

First-Run Setup

Call screen_memory_status before assuming Rewind is ready. If the tool is unavailable, do not stop at a missing-tool error and do not silently install anything:

1. Explain that Rewind requires the signed Clips Desktop app on macOS plus a local agent connection.

2. Ask whether Clips is installed, or use a non-mutating native application lookup when the host supports one. Do not inspect Clips' app-data folders. If Clips is absent or its presence cannot be confirmed, ask permission before opening or downloading anything: “Clips Desktop is required for Rewind. Would you like me to open the official installer and guide you through setup?”

3. Only after affirmative permission, open https://clips.agent-native.com/download in the user's browser. Complete native installation steps only when the current host can safely do so and the user explicitly permitted them. Never bypass Gatekeeper, accept macOS permission prompts, or enable screen/audio capture on the user's behalf.

4. If native UI control is unavailable, return the download link and wait for the user to confirm that Clips is installed and running.

5. Ask the user to enable Rewind in the Clips tray and choose the intended capture mode. Then configure the local connection with:

   npx -y @agent-native/core@latest skills add rewind --client <client> --scope user --yes

   Replace <client> with the current compatible host: codex, claude-code, cursor, opencode, github-copilot, or cowork.

6. Restart the host only if it cannot reload MCP servers in place, then retry screen_memory_status. Do not claim setup succeeded until it reports Rewind enabled and unpaused.

Retrieval Flow

1. Call screen_memory_status first. If the newest segment is still open, wait for it to finalize rather than substituting an older segment.
2. Search screen_memory_search_chapters before requesting raw recent context. Use the user's words, the visible app or project, and the likely time range as clues.
3. If several chapters plausibly match, show the candidates and ask which one the user means. Do not blend separate workstreams together.
4. Read the smallest useful range with screen_memory_recent_context. Restate what you recovered before acting, and flag transcription or coverage uncertainty.
5. Use screen_memory_frame_at for one exact visual moment or screen_memory_contact_sheet to scan a bounded range. Prefer local frames before escalating to cloud processing.
6. Request the smallest relevant timestamp range through Clips' bounded private Clip handoff only when local text and frames are insufficient, such as garbled speech, important motion, dense analysis, or a Clip the user wants to keep and query later.

Boundaries

• Rewind recordings, screenshots, audio, transcripts, OCR, and indexes remain local unless the user explicitly asks for a bounded Clip handoff.

• Do not reveal archive filesystem paths, crawl Clips' app-data folders, or bypass the Screen Memory MCP broker.

• Do not upload frames returned by local Screen Memory tools.

• Treat foreground apps and chapter labels as evidence, not proof of intent.

• If Clips is installed and Rewind is enabled but the Screen Memory MCP is missing, explain that only the agent connection needs repair with:

  npx -y @agent-native/core@latest skills add rewind --client <client> --scope user --yes

  Ask the user to restart the host if it cannot reload MCP servers in place.

• Never conflate installing Clips Desktop with installing the skill/MCP connection, and never claim either succeeded without direct evidence.