screenpipe-team

Query Enterprise team activity and manage team Pipes via the Screenpipe CLI.

21.3k|2.2k|Updated Jun 19, 2024
One-click install
npx skills add https://github.com/screenpipe/screenpipe --skill screenpipe-team
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: screenpipe-team
Source: https://github.com/screenpipe/screenpipe/tree/main/crates/screenpipe-core/assets/skills/screenpipe-team
Command: npx skills add https://github.com/screenpipe/screenpipe --skill screenpipe-team

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enterprise admins need a safe, scoped way to search team screen and audio activity, inspect specific frames, and deploy or schedule managed Pipes without exposing admin tokens or flooding context with raw data.

Core Features & Use Cases

  • Team Activity Search: Search across team devices with time-bounded queries, fetch chronological records, and retrieve individual frames as JPEGs for visual verification.
  • Managed Pipe Lifecycle: Preview, deploy, and schedule team Pipes with explicit confirmation, version-conflict protection, and JSON receipts.
  • Token & Scope Safety: Reads the admin token from Enterprise settings automatically, enforces read/write scopes, and never prints credentials.
  • Use Case: An admin wants to verify what a teammate saw during an incident window. They list devices, run a 24h search, fetch records for the relevant device, and open one cited frame to confirm the on-screen content.

Quick Start

Ask the assistant to search team activity for a topic over the last 24 hours using the screenpipe team CLI and summarize the top results by timestamp and device.

Frequently Asked Questions about screenpipe-team

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search team screen activity with screenpipe?

Run screenpipe team search with a topic, a time window like --since 24h, and a result cap such as -n 20. First list devices with screenpipe team devices to identify the right machine, then narrow the query.

How do I deploy a managed team Pipe in screenpipe?

Preview the Pipe with screenpipe team pipes preview, show the exact target to the user, then run screenpipe team pipes deploy. New deployments default to Cloud Runner unless --device, --member, or --all-runtimes is explicitly chosen.

What token scopes does the screenpipe team CLI require?

Team reads require read:devices, read:search, or read:records scopes, while Pipe management requires write:pipes. Mint or rotate tokens at the Enterprise tokens page, then set them under Settings, Privacy, Admin Team API Token.

Why does a screenpipe team frame command return no image?

A frame may be unavailable for that device or frame ID, and an unavailable frame is not evidence of screen content. Only describe pixels after the frame command succeeds and the JPEG opens in an image tool.

When should I use screenpipe-api instead of the team CLI?

Use screenpipe-api for querying the user's own local machine rather than team data. The screenpipe team skill is injected only by the Enterprise app for active admins managing organization-wide activity and Pipes.