Screenpipe Health
Check Screenpipe health status, process state, and diagnose common issues
Install
npx skills add screenpipe/screenpipe --skill screenpipe-healthgit clone --depth 1 https://github.com/screenpipe/screenpipe.git /tmp/screenpipe
mkdir -p ~/.claude/skills
cp -r /tmp/screenpipe/.claude/skills/screenpipe-health ~/.claude/skills/screenpipe-healthPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# 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 CheckDetails
- Skill name
screenpipe-health- Repository
- screenpipe/screenpipe
- Path
.claude/skills/screenpipe-health/SKILL.md- Repo updated
- 17 November 2026
- Listed in
- BehiSecc/awesome-claude-skills
FAQ
What does the Screenpipe Health skill do?
Check Screenpipe health status, process state, and diagnose common issues
How do I install the Screenpipe Health skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add screenpipe/screenpipe --skill screenpipe-health. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Screenpipe Health popular?
It lives in screenpipe/screenpipe, which has 22,429 GitHub stars and 2,305 forks, and is included in 1 curated skill list.
Related skills
Develop Screenpipe Windows
22kscreenpipe/screenpipe
Develop and test Screenpipe Windows-native changes on a disposable Azure VM created from the prepared Screenpipe Windows dev image. Use for Windows compiler, process, service, local API, desktop, capture, installer, or permission behavior. Do not use for React-only work proved by the browser mock.
Release
22kscreenpipe/screenpipe
Release the screenpipe monorepo. Bumps versions, triggers GitHub Actions for app, CLI, MCP, and JS packages.
Render HTML Report
22kscreenpipe/screenpipe
Produce a human-facing visual report — a chart, dashboard, scorecard, or styled summary — that renders as a live page in the screenpipe viewer instead of plain text. Use when the task asks for a visual/graphical output rather than a plain note; do NOT use for plain text or raw data (prefer a markdown note for those).
Screenpipe Incident Timeline
22kscreenpipe/screenpipe
Reconstruct a bounded incident timeline and separate observed events from suspected causes.
Screenpipe Decision History
22kscreenpipe/screenpipe
Trace why a decision was made, which alternatives were considered, and what changed later.
Screenpipe Interview Synthesis
22kscreenpipe/screenpipe
Analyze one discovery interview for observed behavior, needs, workarounds, and unanswered questions.
Browse the most popular Claude skills, all other skills, or write your own with the skills generator.