screenpipe

1# Screenpipe
2 
3Bring context from [Screenpipe](https://screenpipe.com) into the current task.
4Requires Screenpipe running on the same computer with recording permissions,
5Node.js 20+, and (for saving) claude-mem's local worker.
6 
7## Search
8 
9Use the user's topic and time window. If they omit a window, start with the last
10hour and state that scope. Convert local times to ISO timestamps with timezone
11offsets. Default to screen text (`ocr`, including accessibility-derived text);
12use `audio` for conversations or `all` when both are relevant.
13 
14Before the first search, explain that retrieved text enters the agent conversation
15and is sent to the agent's AI provider. Search results are wrapped in `<private>`
16so claude-mem's automatic capture doesn't store them; only a note the user asks
17to save is stored. This is on-demand retrieval; it does not start recording or
18background sync.
19 
20Run the bundled helper (resolve its path relative to this skill when
21`CLAUDE_SKILL_DIR` is unavailable):
22 
23```bash
24node "${CLAUDE_SKILL_DIR}/screenpipe.mjs" search \
25  --start "2026-10-07T09:00:00-07:00" --end "2026-10-07T10:00:00-07:00" \
26  --query "release plan" --type ocr --limit 20
27```
28 
29Replace the example timestamps and query with the requested scope. Optional
30`--app` filters by application. `SCREENPIPE_URL` defaults to
31`http://127.0.0.1:3030`; `SCREENPIPE_API_KEY` supplies bearer authentication when
32enabled. Both service URLs must be local HTTP origins. Never print API keys.
33…