mcpField
S
screenpipe-cli

screenpipe-cli

github.com/screenpipeエージェントワークフロー22.1k41 回インストール今日更新
リポジトリ

screenpipe-cli について

Screenpipe CLI は、pipes と呼ばれる定期実行の AI 自動化に加え、連携設定や pipe の公開を管理します。このスキルでは、pipes と接続の設定、実行、テスト、トラブルシューティング用コマンドを説明します。

主な機能

  1. 01pipe の一覧表示・有効化・無効化・実行
  2. 02GitHub またはローカルパスから pipe を導入
  3. 03pipe の実行ログを確認
  4. 04サービス接続の管理とテスト
  5. 05pipe をストアに公開

活用シーン

  1. 01定期実行する AI 自動化を設定
  2. 02pipe をテストしてログを確認
  3. 03連携を設定または検証
  4. 04pipe をストアに公開

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/screenpipe/screenpipe --skill screenpipe-cli

インストール後、Claude Code で/screenpipe-cliを入力して読み込まれたか確認します。

詳細

Screenpipe CLI

bun x screenpipe@latest を使用して CLI コマンドを実行します。別途インストールする必要はありません。

重要：node_modules の競合を避けるため、bun x コマンドは必ず空の一時ディレクトリから実行してください。

cd "$(mktemp -d)" && bun x screenpipe@latest <command>

シェル

  • すべてのプラットフォーム → bash（Windows では、同梱の git-portable bash が自動的に使用されます）

パイプ管理

パイプは、スケジュールに従って実行される Markdown ベースの AI 自動化機能です。各パイプは ~/.screenpipe/pipes/<name>/pipe.md にあります。

コマンド
bun x screenpipe@latest pipe list                    # List all pipes (compact table)
bun x screenpipe@latest pipe enable <name>           # Enable a pipe
bun x screenpipe@latest pipe disable <name>          # Disable a pipe
bun x screenpipe@latest pipe run <name>              # Run once immediately (for testing)
bun x screenpipe@latest pipe logs <name>             # View execution logs
bun x screenpipe@latest pipe install <url-or-path>   # Install from GitHub or local path
bun x screenpipe@latest pipe delete <name>           # Delete a pipe
bun x screenpipe@latest pipe models list             # View AI model presets
パイプの作成

YAML フロントマターとプロンプトを含む ~/.screenpipe/pipes/<name>/pipe.md を作成します。

---
schedule: every 30m
enabled: true
preset: ["Primary", "Fallback"]
---

Your prompt instructions here. The AI agent executes this on schedule.

## What to do

1. Query screenpipe search API for recent activity
2. Process results
3. Output summary / send notification

スケジュール構文：every 30m、every 1h、every day at 9am、every monday at 9am、または cron：*/30 * * * *、0 9 * * *

設定フィールド：schedule、enabled（bool）、preset（文字列または配列。例："Oai" または ["Primary", "Fallback"]）、history（bool。前回の出力をコンテキストとして含めるかどうか）

Screenpipe は各実行の前に、時間範囲、タイムゾーン、OS、API URL を含むコンテキストヘッダーを追加します。テンプレート変数は不要です。

作成後：

bun x screenpipe@latest pipe install ~/.screenpipe/pipes/my-pipe
bun x screenpipe@latest pipe enable my-pipe
bun x screenpipe@latest pipe run my-pipe   # terminal-only; in-app chat uses the workflow below
アプリ内チャットでのテスト

クラウド JWT は意図的に Bash から除外されています。JWT を公開したり復元したりせず、単独の pipe run も使用しないでください。認証済みのデスクトップランタイムを通じてテストします。

api="${SCREENPIPE_LOCAL_API_URL:-http://localhost:3030}"
auth="Authorization: Bearer $SCREENPIPE_LOCAL_API_KEY"
curl -sS -X POST -H "$auth" "$api/pipes/my-pipe/run"
curl -sS -H "$auth" "$api/pipes/my-pipe/logs"

{"success":true} は実行が開始されたことを意味するもので、実行が成功したことを示すものではありません。新しい最終ログが出るまでポーリングしてください。success: true の場合にのみバインドしてください。それ以外の場合は stderr を報告し、Live View は変更しないでください。

設定の編集

~/.screenpipe/pipes/<name>/pipe.md のフロントマターを直接編集するか、API を使用します。

curl -X POST http://localhost:3030/pipes/<name>/config \
  -H "Content-Type: application/json" \
  -d '{"config": {"schedule": "every 1h", "enabled": true}}'
ルール
  1. pipe list（--json ではなく）を使用してください。テーブル形式の出力はコンパクトです
  2. パイプの JSON 全体を出力しないでください。15MB 以上になることがあります
  3. デバッグ時は、まずログを確認してください：pipe logs <name>
  4. アプリ内チャット以外では、スケジュールを待つ前に pipe run <name> を使用してください。アプリ内チャットでは、上記の認証済みランタイムを使用します

接続管理

CLI からインテグレーション（Telegram、Slack、Discord、Email、Todoist、Teams）を管理します。

コマンド
bun x screenpipe@latest connection list              # List all connections + status
bun x screenpipe@latest connection list --json       # JSON output
bun x screenpipe@latest connection get <id>          # Show status + non-secret settings
bun x screenpipe@latest connection get <id> --json   # JSON output
bun x screenpipe@latest connection set <id> key=val  # Save credentials
bun x screenpipe@latest connection test <id>         # Test a connection
bun x screenpipe@latest connection remove <id>       # Remove credentials
例
# Set up Telegram
bun x screenpipe@latest connection set telegram bot_token=123456:ABC-DEF chat_id=5776185278

# Set up Slack webhook
bun x screenpipe@latest connection set slack webhook_url=https://hooks.slack.com/services/...

# Verify it works
bun x screenpipe@latest connection test telegram

# Check what's connected
bun x screenpipe@latest connection list

接続 ID：telegram、slack、discord、email、todoist、teams、google-calendar、openclaw

認証情報はローカルに保存され、connection get では表示されません。

インテグレーションごとの詳細：このスキルの情報だけから API の形式を推測しないでください。自己記述型のローカルエンドポイントについては、connection list を実行してください。connection get <id> が返すのは、ステータスと秘密情報以外の設定のみです。

パイプのストアへの公開

screenpipe pipe publish <pipe-name>

~/.screenpipe/pipes/<pipe-name>/pipe.md を読み込み、YAML フロントマターからタイトル、説明、アイコン、カテゴリを抽出して、screenpipe のパイプストアに公開します。認証が必要です（SCREENPIPE_API_KEY 環境変数または ~/.screenpipe/auth.json）。

コメント

Markdown 対応