Screenpipe Logs

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

22,429 stars 2,305 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add screenpipe/screenpipe --skill screenpipe-logs
Manual install
git clone --depth 1 https://github.com/screenpipe/screenpipe.git /tmp/screenpipe
mkdir -p ~/.claude/skills
cp -r /tmp/screenpipe/.claude/skills/screenpipe-logs ~/.claude/skills/screenpipe-logs

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# 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
Read the full skill on GitHub

Details

Skill name
screenpipe-logs
Path
.claude/skills/screenpipe-logs/SKILL.md
Repo updated
17 November 2026

FAQ

What does the Screenpipe Logs skill do?

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

How do I install the Screenpipe Logs skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add screenpipe/screenpipe --skill screenpipe-logs. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Screenpipe Logs 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

22k

screenpipe/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.

Software DevelopmentIn 1 list2.3k

Release

22k

screenpipe/screenpipe

Release the screenpipe monorepo. Bumps versions, triggers GitHub Actions for app, CLI, MCP, and JS packages.

Git & Code ReviewIn 1 list2.3k

Render HTML Report

22k

screenpipe/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).

Productivity & NotesIn 1 list2.3k

Screenpipe Tauri

22k

screenpipe/screenpipe

Add or change Tauri commands and TypeScript bindings in the screenpipe desktop app. Use when editing #[tauri::command] handlers, lib/utils/tauri.ts, or Rust types exported to the frontend.

Software DevelopmentIn 1 list2.3k

Screenpipe CLI

22k

screenpipe/screenpipe

Set up and operate screenpipe from the terminal, including always-on recording, service modes, capture health, storage, local search, pipes, and connections. Use when the user asks to install, run, inspect, query, automate, or debug screenpipe without relying on the desktop app.

Software DevelopmentIn 1 list2.3k

Plannotator

13k

backnotprop/plannotator

Reference for using Plannotator (its `plannotator` tool when you have one, otherwise the CLI): plan review, code review, annotating files, URLs, folders, and running local apps, annotating the last assistant message, browsing archived plan decisions, exporting or sharing Guided Reviews, and the Plannotator Inbox (messages and questions the person answers later, without blocking you). Invoke when asked to use Plannotator for anything not covered by a more specific plannotator-* skill, and before you leave the person a decision, a question or finished work in the Plannotator Inbox (if another ag

Software DevelopmentIn 2 lists1.3k

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.