Skip to main content
a lot of people connect screenpipe to a personal AI agent — OpenClaw, Hermes, Claude Code, Codex, Cursor — and then only ever use it to ask questions on demand (“what was I reading yesterday?”). the bigger win is to let your agent build a second brain about you in the background: it watches what you do through screenpipe, splits your day into distinct workflows, writes higher-level summaries of your processes, and keeps a durable memory of who you are and what you’re working on — so you never have to re-explain your context again. this is the same idea as the digital clone pipe (which builds a persistent AI memory of you inside the screenpipe app), but it lives inside your own agent’s memory. you set it up by pasting one prompt.
this works with any agent that can run a tool/shell and run on a schedule. it does not require the screenpipe app’s pipes — your agent does the work.

1. connect screenpipe first

your agent needs to be able to read your activity. the fastest way is the screenpipe MCP server — add it to your agent’s MCP config:
this gives your agent the search-content, activity-summary, list-meetings, and update-memory tools.
  • running your agent on a VPS or a different machine than screenpipe (common with OpenClaw / Hermes)? see OpenClaw → different machines for querying over Tailscale or pushing your ~/.screenpipe data with npx -y screenpipe@latest sync remote. the same steps work for Hermes and any other agent.
  • not using MCP? your agent can hit the local REST API directly at http://localhost:3030 — see MCP server setup and api recipes.
it also helps to load the screenpipe skills (or the equivalent for your agent) so it navigates the data efficiently.

2. paste this into your agent

copy this prompt into OpenClaw, Hermes, Claude, Codex, Cursor, or any agent connected to screenpipe:

what it builds

after a few runs you’ll have a self-maintaining memory of yourself:

run it on a schedule

the prompt above tells the agent to schedule itself, but you control the cadence with whatever your agent supports:
  • OpenClaw / Hermes — their built-in automations / scheduled tasks
  • Claude Code — claude tasks
  • Codex — codex automations
  • screenpipe pipe — run it inside screenpipe itself: save the prompt to ~/.screenpipe/pipes/second-brain/pipe.md with a schedule (e.g. 0 * * * *), then npx -y screenpipe@latest pipe install ~/.screenpipe/pipes/second-brain && npx -y screenpipe@latest pipe enable second-brain (bunx / bun x work too — see pipes)
  • anything else — a plain cron / launchd / systemd timer that re-runs the prompt
hourly is a good default. lighter machines can run every few hours; use activity-summary first to keep token usage low.

privacy

screenpipe data is local. the agent only sees what you let it reach (MCP on localhost, your REST API, or the ~/.screenpipe data you sync). the prompt explicitly tells the agent not to store secrets or private data in your second brain. if your agent runs on a remote VPS, also follow the clipboard note in OpenClaw → different machines so passwords and keys that pass through your clipboard aren’t synced off-device.

next steps