# Screenpipe Health

Check Screenpipe health status, process state, and diagnose common issues

- Repository: https://github.com/screenpipe/screenpipe (22202 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add screenpipe/screenpipe --skill screenpipe-health -g -a claude-code -y`
Codex: `npx skills add screenpipe/screenpipe --skill screenpipe-health -g -a codex -y`
Cursor: `npx skills add screenpipe/screenpipe --skill screenpipe-health -g -a cursor -y`
Gemini CLI: `npx skills add screenpipe/screenpipe --skill screenpipe-health -g -a gemini-cli -y`

## Description

Check Screenpipe health status, process state, and diagnose common issues

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Screenpipe Health Agent

You are a specialized agent for checking Screenpipe's health status and diagnosing issues.

## Quick Health Check

### 1. Check if Screenpipe is Running
```bash
# Check for screenpipe processes
pgrep -fl screenpipe

# Check if API is responding
curl -s http://localhost:3030/health | head -100
```

### 2. Check Recording Status
```bash
# Get health with recording info
curl -s http://localhost:3030/health | jq '.frame_status, .audio_status' 2>/dev/null || curl -s http://localhost:3030/health
```

### 3. Check Disk Usage
```bash
# Screenpipe data directory size
du -sh ~/.screenpipe/

# Database size
ls -lh ~/.screenpipe/db.sqlite* 2>/dev/null

# Video/audio cache
du -sh ~/.screenpipe/data/ 2>/dev/null
```

### 4. Check Recent Logs for Errors
```bash
# Last 10 errors from today
grep -i "error" ~/.screenpipe/screenpipe.$(date +%Y-%m-%d).log 2>/dev/null | tail -10
```

## Detailed Diagnostics

### Process Information
```bash
# Detailed process info
ps aux | grep -i screenpipe | grep -v grep

# Memory usage
ps aux | grep -i screenpipe | grep -v grep | awk '{sum+=$6} END {print "Total Memory: " sum/1024 " MB"}'

# Check if app or CLI
pgrep -fl "screenpipe-app" && echo "Desktop app running"
pgrep -fl "screenpipe$" && echo "CLI running"
```

### API Endpoints Check
```bash
# Health endpoint (includes vision + audio pipeline stats)
curl -s http://localhost:3030/health

# Search endpoint (test query)
curl -s "http://localhost:3030/search?limit=1" | head -50

# List audio devices
curl -s http://localhost:3030/audio/list

# List monitors
curl -s http://localhost:3030/vision/list

# Vision pipeline metrics (raw counters)
curl -s http://localhost:3030/vision/metrics

# Audio pipeline metrics (raw counters)
curl -s http://localhost:3030/audio/metrics
```

The rest: https://github.com/screenpipe/screenpipe/blob/HEAD/.claude/skills/screenpipe-health/SKILL.md