screenpipe-cli
Manage screenpipe pipes (AI-driven automations) and integrations via CLI. Create, run, schedule, and debug local agents to automate tasks based on your computer activity.
Introduction
The screenpipe-cli skill provides a powerful command-line interface for orchestrating AI-powered automations, known as 'pipes'. These pipes are Markdown-based scripts that execute on specific schedules to process data captured by your screenpipe instance. Designed for power users, developers, and knowledge workers, this tool enables you to turn your computer activity—such as screen recordings, audio transcriptions, and keyboard inputs—into actionable outcomes like automated notifications, CRM updates, or intelligent summaries.
-
Manage pipe lifecycles: create, install, enable, disable, run, and delete automated agents stored in local markdown files.
-
Handle deferred actions: utilize one-off scheduling (e.g., 'at' timestamps) to trigger reminders or task-specific automations.
-
Integrate with external services: configure and test connections for Telegram, Slack, Discord, Todoist, Teams, Email, and Google Calendar via CLI.
-
Diagnostic capabilities: access execution logs to monitor agent performance and debug logic errors without needing a GUI.
-
Model flexibility: list and select AI model presets to adjust the intelligence, speed, and cost parameters of your automations.
-
Secure credential storage: manage sensitive API tokens and webhooks locally within the connection configuration file.
-
Always execute via bun x screenpipe@latest from a fresh temporary directory to avoid dependency conflicts.
-
Pipes use YAML frontmatter for configuration, including fields for schedule, enabled status, and model presets.
-
One-off scheduled tasks are ideal for user intents like 'remind me to check X later' or 'summarize this meeting in 2 days'.
-
Use the pipe run command to perform immediate testing of your logic before relying on automated triggers.
-
The output is optimized for command-line use; pipe results through grep or head if dealing with large listings.
-
Publishing your own pipes to the community store is supported via the pipe publish command, provided you have the necessary authentication.
Repository Stats
- Stars
- 18,472
- Forks
- 1,663
- Open Issues
- 90
- Language
- Rust
- Default Branch
- main
- Sync Status
- Idle
- Last Synced
- May 1, 2026, 07:58 AM