Skip to main content
want the fastest path? see the 5-minute quickstart →

​
desktop app or CLI?

download the desktop app and follow the installation instructions. works on macOS, Windows, and Linux. the app manages recording, settings, search, pipes, and AI connections — no terminal needed.

​
CLI

this starts the screenpipe daemon in the background and continuously records your screen. data is stored in ~/.screenpipe/ on your local machine.

​
troubleshooting: “npx -y screenpipe@latest record” not working

if the command fails, try these fixes in order: unsupported platform:
if the output is not darwin-arm64, darwin-x64, linux-x64, or win32-x64, your platform is not supported. missing platform package (macOS/Windows/Linux):
the CLI needs the platform-specific binary. re-running with npx -y screenpipe@latest pulls a fresh copy. macOS: binary blocked by Gatekeeper: if you see “app is damaged” or “permission denied”, run:
or use the desktop app instead — it handles permissions automatically. Linux: missing system libraries:
Windows: .NET runtime missing: the screenpipe installer includes .NET, but if you’re using the CLI only, install .NET 8.0. port 3030 already in use: if screenpipe is already running, the CLI will fail to bind. check for existing processes:
still stuck? ask in Discord.

​
suppress CLI reminders (optional)

when running npx -y screenpipe@latest record, the CLI prints a friendly reminder every 5 minutes to download the desktop app. if you prefer to run the CLI silently, disable the reminders:
or set it once in your shell:

​
access your recorded timeline

after starting the CLI, you have three ways to access your screen history:
  1. Desktop app (easiest) — download the screenpipe app for a visual timeline and built-in search
  2. REST API — query recorded content directly via curl or code (see below)
  3. AI assistants — connect Claude, Cursor, or other tools via MCP

​
verify it’s running

once screenpipe starts, it serves an API on localhost:3030:
if you’ve enabled API auth in settings, add -H "Authorization: Bearer <your-api-key>" to these requests. by default the local API needs no auth.

​
check and update your version

to ensure you’re running the latest version:
to update to the latest version, just run with @latest — it always pulls the newest release:
the latest version is always available at npm. if you’re on an older version, you’ll see a warning when you run npx -y screenpipe@latest record.

​
API authentication (if enabled)

by default the local API on localhost:3030 needs no auth. if you’ve turned on API auth in settings, get your key by running:
then use it in curl:
or set it as an environment variable:

​
connect to AI

screenpipe works with any AI that supports MCP or HTTP APIs. the fastest path is one command — it installs the screenpipe skills and registers the MCP server for your agent:
where <target> is one of openclaw, hermes, claude-code, claude-desktop, codex, cursor, or windsurf. add --api-url <URL> if screenpipe runs on another machine. prefer to wire it up manually? here’s where each tool plugs in:

​
what’s next?

browse pipes

see all available automations — day recap, standup, time tracking, and more

connect your AI

add screenpipe to Claude, Cursor, ChatGPT, or any AI tool

connect your apps

link Calendar, Google Docs, Notion, Obsidian for richer context

what can I do?

explore use cases — loop closing, meeting notes, time tracking, and more

API recipes

copy-paste local API workflows for search, meetings, speakers, frames, and retention
download screenpipe →