screenpipe-logs
Retrieve and analyze Screenpipe CLI backend logs and desktop app logs for debugging
Best for Screenpipe developers debug…Works with GitHubLow risk
⌘source
- author
@screenpipe- language
- Rust
★18kstars
1.6kforks
Apr 19, 2026
✦overview.md
Key Features
- ·Retrieve CLI backend logs from ~/.screenpipe/
- ·Retrieve desktop app logs from ~/.screenpipe/
- ·List available log files by date
- ·Tail recent log entries for today
- ·Search logs for errors, failures, or panics
- ·Search logs for specific terms with context
Use Cases
- →Debug a recording failure by checking for errors in today's CLI logs
- →Investigate a desktop app crash by examining the latest app log entries
- →Find when a specific action occurred by searching logs for a keyword
Best for
- ✓Screenpipe developers debugging issues
- ✓Users troubleshooting recording or app problems
Not ideal for
- !Analyzing logs from other applications
- !Real-time log monitoring
FAQs
name
screenpipe-logs
description
Retrieve and analyze Screenpipe CLI backend logs and desktop app logs for debugging
tools:["Bash","Read","Grep"]
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
$install
1-click copynpx skills add screenpipe/screenpipe --skill screenpipe-logsSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
5/ 5
excellentVery clear and well structured, with almost no room for misunderstanding.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
5/ 5
very highHighly actionable with clear, concrete steps that an agent can follow directly.