Screenpipe user-feedback

Name: user-feedback
Author: screenpipe

Query user feedback logs submitted via the app's "send logs" button. Use when debugging user-reported issues, searching for crash patterns, or reviewing feedback.

install

source · Clone the upstream repo

git clone https://github.com/screenpipe/screenpipe

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/screenpipe/screenpipe "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/user-feedback" ~/.claude/skills/screenpipe-screenpipe-user-feedback && rm -rf "$T"

manifest: .claude/skills/user-feedback/SKILL.md

source content

User Feedback Logs

Query feedback and logs submitted by users through the screenpipe app's "send logs" button. Data is stored in Supabase and accessible via the admin logs API.

Setup

The API requires a bearer token. Set

LOGS_ADMIN_SECRET

in your environment or pass it directly. Ask the project maintainer for the token if you don't have it.

export LOGS_ADMIN_SECRET="<token>"

API Endpoint

GET https://screenpi.pe/api/admin/logs
Authorization: Bearer $LOGS_ADMIN_SECRET

Query Parameters

Param	Description	Example
`q`	Search feedback text (case-insensitive)	`q=crash`
`os`	Filter by OS	`os=darwin` , `os=windows` , `os=linux`
`app_version`	Exact version match	`app_version=2.2.290`
`identifier`	Filter by user/machine ID
`screenpipe_id`	Filter by analytics ID
`from`	Start date (ISO 8601)	`from=2026-03-30T00:00:00`
`to`	End date (ISO 8601)	`to=2026-03-31T00:00:00`
`limit`	Results per page (max 200)	`limit=20`
`offset`	Pagination offset	`offset=20`

Common Queries

Recent feedback (last 24h)

curl -s "https://screenpi.pe/api/admin/logs?limit=20&from=$(date -u -v-24H '+%Y-%m-%dT%H:%M:%S' 2>/dev/null || date -u -d '24 hours ago' '+%Y-%m-%dT%H:%M:%S')" \
  -H "Authorization: Bearer $LOGS_ADMIN_SECRET" | jq '.logs[] | {created_at, os, app_version, feedback: .feedback_text}'

Search for a keyword in feedback

curl -s "https://screenpi.pe/api/admin/logs?q=audio&limit=20" \
  -H "Authorization: Bearer $LOGS_ADMIN_SECRET" | jq '.logs[] | {created_at, os, app_version, feedback: .feedback_text}'

Windows-only issues

curl -s "https://screenpi.pe/api/admin/logs?os=windows&limit=30" \
  -H "Authorization: Bearer $LOGS_ADMIN_SECRET" | jq '.logs[] | {created_at, os_version, app_version, feedback: .feedback_text}'

Feedback for a specific version

curl -s "https://screenpi.pe/api/admin/logs?app_version=2.2.290&limit=50" \
  -H "Authorization: Bearer $LOGS_ADMIN_SECRET" | jq '.logs[] | {created_at, os, feedback: .feedback_text}'

Count total feedback entries

curl -s "https://screenpi.pe/api/admin/logs?limit=1" \
  -H "Authorization: Bearer $LOGS_ADMIN_SECRET" | jq '{total: .total}'

Response Shape

{
  "logs": [
    {
      "id": "uuid",
      "type": "user",
      "identifier": "user_abc123",
      "os": "darwin",
      "os_version": "15.3.2",
      "app_version": "2.2.290",
      "feedback_text": "audio stopped working after update",
      "screenpipe_id": "analytics_id",
      "created_at": "2026-03-30T15:30:00Z",
      "file_path": "logs/user/abc123/2026-03-30T15:30:00.log",
      "screenshot_url": "logs/user/abc123/2026-03-30T15:30:00_screenshot.png",
      "video_url": "logs/user/abc123/2026-03-30T15:30:00_video.mp4"
    }
  ],
  "total": 1234,
  "limit": 20,
  "offset": 0
}

Tips

```
file_path
```
,
```
screenshot_url
```
, and
```
video_url
```
are S3 keys, not direct URLs. You can't download them directly — they need signed URLs generated server-side.
```
feedback_text
```
can be null if the user just sent logs without writing a message.
```
identifier
```
is either a Clerk user ID (starts with
```
user_
```
) or a random machine UUID for anonymous users.
Results are always sorted newest first.
Use
```
from
```
/
```
to
```
to narrow time ranges when investigating specific incidents.
Cross-reference
```
app_version
```
with git tags to check if the issue is fixed in a newer release.