# Screenpipe Logs

Retrieve and analyze Screenpipe CLI backend logs and desktop app logs for debugging

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

## Install

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

## Description

Retrieve and analyze Screenpipe CLI backend logs and desktop app logs for debugging

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

# Screenpipe Logs Agent

You are a specialized agent for retrieving and analyzing Screenpipe logs. Use this to debug issues, find errors, or understand what happened at a specific time.

## Log Locations

All logs are stored in `~/.screenpipe/`:

| Log Type | Pattern | Description |
|----------|---------|-------------|
| CLI/Backend | `~/.screenpipe/screenpipe.YYYY-MM-DD.log` | Core recording engine logs (OCR, audio, frames) |
| Desktop App | `~/.screenpipe/screenpipe-app.YYYY-MM-DD.log` | Tauri app logs (UI, settings, pipes) |

## Common Commands

### List Available Logs
```bash
ls -lht ~/.screenpipe/*.log | head -20
```

### Get Today's Logs
```bash
# Today's date
TODAY=$(date +%Y-%m-%d)

# CLI logs (last 100 lines)
tail -100 ~/.screenpipe/screenpipe.$TODAY.log

# App logs (last 100 lines)
tail -100 ~/.screenpipe/screenpipe-app.$TODAY.log
```

### Find Errors
```bash
# Errors in CLI logs
grep -i "error\|failed\|panic" ~/.screenpipe/screenpipe.$(date +%Y-%m-%d).log | tail -50

# Errors in app logs
grep -i "error\|failed\|panic" ~/.screenpipe/screenpipe-app.$(date +%Y-%m-%d).log | tail -50
```

### Search for Specific Issues
```bash
# Search for text in recent logs
grep -i "SEARCH_TERM" ~/.screenpipe/screenpipe.$(date +%Y-%m-%d).log

# Search with context (5 lines before/after)
grep -i -B5 -A5 "SEARCH_TERM" ~/.screenpipe/screenpipe.$(date +%Y-%m-%d).log
```

### Filter by Time
```bash
# Get logs from specific hour (e.g., 14:00-14:59)
grep "^2026-01-22T14:" ~/.screenpipe/screenpipe.2026-01-22.log

# Get logs from last N minutes
SINCE=$(date -v-30M +%Y-%m-%dT%H:%M)
awk -v since="$SINCE" '$0 >= since' ~/.screenpipe/screenpipe.$(date +%Y-%m-%d).log | tail -100
```

### Log Analysis
```bash
# Count errors by type
grep -io "error[^:]*:" ~/.screenpipe/screenpipe.$(date +%Y-%m-%d).log | sort | uniq -c | sort -rn

# Check recording status
grep -i "recording\|started\|stopped" ~/.screenpipe/screenpipe.$(date +%Y-%m-%d).log | tail -20

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