screenpipe-health

Monitor and diagnose Screenpipe health, processes, disk usage, and API endpoints.

372|35|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/qqqqqf-q/Arkloop --skill screenpipe-health
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: screenpipe-health
Source: https://github.com/qqqqqf-q/Arkloop/tree/main/src/plugins/activity-recorder/skills/screenpipe-health
Command: npx skills add https://github.com/qqqqqf-q/Arkloop --skill screenpipe-health

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Bash, WebFetch, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a comprehensive set of tools to monitor the health status, diagnose issues, and check the performance of the Screenpipe application.

Core Features & Use Cases

  • Health Checks: Quick and detailed checks for the status of Screenpipe processes, recording, disk usage, and logs.
  • Process Information: Detailed information about running processes, memory usage, and app type (Desktop or CLI).
  • API Endpoints Check: Verification of the functionality of different API endpoints, including health, search, and metrics.
  • Audio Pipeline Diagnostics: Inspect the audio pipeline's performance, including transcription, processing, and database interactions.
  • Database Health: Validate database integrity, size, and table content.
  • Permissions Check: Ensure that Screenpipe has the necessary permissions for screen recording and microphone access.
  • Common Issues & Fixes: Guidance on common problems and their solutions, such as starting the application, checking permissions, and interpreting metrics.

Quick Start

Run the health check for Screenpipe by executing the following command: screenpipe health.

Frequently Asked Questions about screenpipe-health

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check Screenpipe health and diagnose performance issues?

Screenpipe health monitoring is performed by running `screenpipe health`, which checks running processes, recording status, disk usage, logs, and API endpoint functionality to diagnose performance issues.

How do I diagnose the audio pipeline if Screenpipe transcription is failing?

Audio pipeline diagnostics inspect transcription, processing, and database interactions to identify failures. The health check validates the full pipeline integrity and pinpoints where audio data processing breaks down.

Can I check Screenpipe database size and table content for health monitoring?

Yes, database health validation is a core feature of system performance monitoring. The diagnostic process checks database integrity, overall size, and specific table content to ensure Screenpipe data is stored correctly.

Does the Screenpipe health check verify microphone and screen recording permissions?

Yes, the health check includes a permissions check to ensure Screenpipe has the necessary system access for screen recording and microphone input. It also provides guidance on resolving common permission-related issues.

What dependencies do I need to run diagnostics on the Screenpipe API endpoints?

You need Bash and WebFetch dependencies to run Screenpipe API endpoint diagnostics. These tools facilitate verifying the functionality of health, search, and metrics endpoints during the system health check.

Why is my Screenpipe system not recording, and how do I fix common issues?

Screenpipe may fail to record due to missing permissions, inactive processes, or disk space limits. The health check identifies these common issues and provides guidance on starting the application and interpreting metrics.