desktop app
download the desktop app and follow the installation instructions. works on macOS, Windows, and Linux. the app manages recording, settings, and search — no terminal needed.CLI
~/.screenpipe/ on your local machine.
access your recorded timeline
after starting the CLI, you have three ways to access your screen history:- Desktop app (easiest) — download the screenpipe app for a visual timeline and built-in search
- REST API — query recorded content directly via curl or code (see below)
- AI assistants — connect Claude, Cursor, or other tools via MCP
verify it’s running
once screenpipe starts, it serves an API onlocalhost:3030:
connect to AI
screenpipe works with any AI that supports MCP or HTTP APIs:what’s next?
- search your screen history — find anything you’ve seen
- set up pipes — scheduled AI agents on your data
- API reference — REST API endpoints and parameters
- join our discord — get help from the community