rewind — Claude Code skill: what it does, how to install
The rewind skill for Claude Code retrieves local screen context using Clips Desktop. The agent runs it when asked about recent events or previous screen activity.
MIT 123 installs ★ 4,679 updated 2026-10-22
npx skills add BuilderIO/skills --skill rewind -a claude-codeWhat rewind does
The skill acts as local screen memory, calling screen_memory_status before searching chapters and recent context. Setup requires the signed Clips Desktop app on macOS and a local agent connection configured via npx -y @agent-native/core@latest skills add rewind --client <client> --scope user --yes. Recordings, screenshots, and indexes remain local unless the user explicitly triggers a private Clip handoff.
The agent checks memory status first and directs to https://clips.agent-native.com/download for Clips Desktop installation if needed. Tools like screen_memory_frame_at and screen_memory_contact_sheet read exact moments and bounded ranges without cloud processing. The skill never bypasses Gatekeeper or enables screen capture without explicit permission.
What it helps with
- retrieve recent local screen context
- search screen history through chapters
- verify screen memory status
- inspect exact visual frames from past activity
Example prompts for the agent
- Look at Rewind and tell me what just happened
- What was I looking at a moment ago?
- Find that recent clip in screen memory
How to install rewind
1Skills CLI (Vercel)
npx skills add BuilderIO/skills --skill rewind -a claude-code2Manually: put the files in place
~/.claude/skills/rewind/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/rewind/
1Skills CLI (Vercel)
npx skills add BuilderIO/skills --skill rewind -a codex2Manually: put the files in place
.agents/skills/rewind/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add BuilderIO/skills --skill rewind -a cursor2Manually: put the files in place
.cursor/skills/rewind/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install BuilderIO/skills skills/rewind2Manually: put the files in place
.github/skills/rewind/SKILL.md1Skills CLI (Vercel)
npx skills add BuilderIO/skills --skill rewind -a gemini-cli2Platform CLI
gemini skills install https://github.com/BuilderIO/skills --path skills/rewindManually: put the files in place
.devin/skills/rewind/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add BuilderIO/skills --skill rewind -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about rewind
How to install rewind in Claude Code?
Run npx skills add BuilderIO/skills --skill rewind -a claude-code and check ~/.claude/skills/rewind/SKILL.md.
What does rewind do?
The skill retrieves local screen context and recent visual memory from Clips Desktop when requested.
What is required to run rewind?
It requires macOS, the signed Clips Desktop app, and a local agent connection.
Source text
SKILL.md · MIT
--- 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.
© BuilderIO · MIT · BuilderIO/skills