Rewind

First-Run Setup

screen_memory_status

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.