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

ls -lht ~/.screenpipe/*.log | head -20

Get Today's Logs

# 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

# 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

# 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

# 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

# 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