AI agent skill · by @screenpipe

Screenpipe Team

Use the native Screenpipe CLI to query Enterprise team activity or safely preview, deploy, and schedule managed team Pipes. Injected only by the Enterprise app for active admins.

Archived 2026-10-23 · Source updated 2026-09-19. Check the original repository for the latest version.

SKILL.md instructions

# Screenpipe Enterprise admin

Use `screenpipe team`; it reads the admin token and API base from Screenpipe's
Enterprise settings. Never print tokens or read `enterprise.json` into context.

## Choose the smallest command

```bash
# Identify a device before searching for one teammate.
screenpipe team devices --raw

# Search first; default to 24h and at most 20 results.
screenpipe team search "TOPIC" --since 24h -n 20 --raw > /tmp/sp-team.jsonl

# Fetch a short chronology only after the device and window are known.
screenpipe team records --device-id DEVICE --since 4h --kind all -n 50 --raw > /tmp/sp-team.jsonl

# Fetch at most 2-3 cited frames, then open the JPEG with your image tool.
sp_team_frame_dir="$(mktemp -d)"
screenpipe team frame --device-id DEVICE --frame-id FRAME_ID --output "$sp_team_frame_dir/frame.jpg"
```

Only describe pixels after the frame command succeeds and your image tool opens
the JPEG. An unavailable frame is not evidence about what was on screen.

Keep context small: check `wc -c /tmp/sp-team.jsonl`; if it exceeds 5 KB,
filter with `jq` or narrow the query/window instead of printing the whole file.
Reference results by timestamp and device, quote only short snippets, respect
anonymous `user_*` labels, and do not volunteer unrelated employee data.

For the user's own machine, use `screenpipe-api`, not this skill.

## Managed team Pipes

```bash
screenpipe team pipes list
screenpipe team pipes preview ./my-pipe/pipe.md
screenpipe team pipes deploy ./my-pipe/pipe.md
screenpipe team pipes schedule my-pipe "every day at 9am"
```

Before any mutation, show the exact preview and target. New deployments default
to Cloud Runner; use `--device`, `--member`, or `--all-runtimes` only when the
user explicitly chooses that scope. Use `--yes` for automation only after the
same preview is accepted. Version conflicts fail closed; re-list and re-preview
rather than overwriting a teammate's change. Use `--json` for structured
receipts.

The CLI explains missing-token and scope errors. Team reads require the relevant
`read:devices`, `read:search`, or `read:records` scope; Pipe management requires
`write:pipes`. Direct the user to <https://screenpi.pe/enterprise?tab=tokens> to
mint or rotate a token, then Settings → Privacy → Admin Team API Token.