labelhead-artist-momentum

クイックスタート · ドキュメント · GitHub · Discord · Twitter · ウェブサイト

Paperclip Cloudのウェイトリストに登録 →

# Paperclipは、仕事用のAIエージェントを管理するためのアプリです。

AI エージェントチーム向けのオープンソースのオーケストレーション。

OpenClawが_従業員_なら、Paperclipは_会社_です。

Paperclipは、AIエージェントチームを統括してビジネスを運営する、Node.jsサーバーとReact UIです。エージェントを自由に用意して目標を割り当て、ひとつのダッシュボードから作業とコストを追跡できます。エージェントごとにモデルとハーネスを選びながら、チームのタスク、スキル、権限、履歴を一か所で管理できます。

見た目はタスクマネージャーです。その内部では、組織図、予算、ガバナンス、目標の連携、エージェントの調整を行います。

プルリクエストではなく、ビジネス目標を管理しましょう。

	手順	例
01	目標を定める	「月間経常収益（MRR）100万ドルを達成する、世界一のAIメモアプリを作る。」
02	チームを採用する	CEO、CTO、エンジニア、デザイナー、マーケター — どんなボットでも、どのプロバイダーでも。
03	承認して実行する	戦略を確認します。予算を設定します。実行を開始します。ダッシュボードから監視します。

カスタムプロセス、HTTPエンドポイント、外部アダプターパッケージを使って、対応製品を拡張できます。セットアップと機能については、アダプターの概要をご覧ください。

## Paperclip が適しているのは、次のような方です

• ✅ 自律型 AI 組織を構築したい
• ✅ 共通の目標に向けて、さまざまなエージェント（OpenClaw、Codex、Claude、Cursor）を調整したい
• ✅ Claude Code のターミナルを20個同時に開いていて、各自が何をしているのか把握できなくなっている
• ✅ エージェントに24時間365日自律的に稼働してほしい一方で、作業を監査し、必要に応じて口を挟みたい
• ✅ コストを監視し、予算を適用したい
• ✅ タスクマネージャーを使うような感覚でエージェントを管理できるプロセスがほしい
• ✅ 自律型ビジネスをスマートフォンから管理したい

4つの柱

AI エージェントの組織が実際に成果を出すには、タスク、組織、トレーニング、インフラストラクチャの4つが機能する必要があります。Paperclip は、まさにこの4つの柱を中心に構築されています。

柱	対象	内容
エージェント型タスクマネージャー — 意図を伝えれば、エージェントが作業します。出力を確認するのはあなたです。	すべての人、日常的な利用	タスク、承認、レビューゲート · 先回りして働くエージェントの同僚 · 監査可能な定型業務とワークフロー · 差分、スクリーンショット、テストによる検証
エージェントの組織図 — 人間とエージェントの役割、権限、境界を定めます。	マネージャー	人間とエージェントが混在する組織図 · 責任、委任、専門化 · ガバナンス：誰が何をできるか · スコープを限定したシークレットと会社の境界 · 接続権限と責任者の ID
エージェント従業員のトレーニング — AI 従業員を設計、トレーニング、評価します。	支援者	Skill Studio と組織全体で共有するスキル · 評価と保存済みのテスト実行 · 継続的な学習ループと品質指標 · エージェントのパフォーマンスレビュー · 保存済みのテスト入力 · スキルのバージョン履歴と復元 · 再利用可能なチームテンプレート
エージェント型 OS — 作業を実行するためのインフラストラクチャです。	IT とプラットフォーム	プロバイダーを横断するランタイム：あらゆるモデル、あらゆるエージェント · サンドボックス化、インテグレーション、MCP サーバー · SSO、GRC、RBAC、コスト管理 · データプライバシー、内部トレース収集、蓄積するデータの価値 · 個人用および共有のアプリ接続 · 実行履歴とオプトイン方式のトレース

## 機能

🔌 エージェントを自由に選択 どのエージェントも、どのランタイムも、1つの組織図に。ハートビートを受け取れるなら、採用できます。	🎯 目標との連携 タスクやプロジェクトを組織の目標に結び付けます。エージェントは、自分の作業の背景にある目標のコンテキストを受け取ります。	💓 ハートビート エージェントは、割り当てられた作業、フォローアップメッセージ、または設定されたスケジュールに応じて起動します。委任は組織図に沿って上下に行われます。
💰 コスト管理 会社、エージェント、プロジェクトごとの予算を設定できます。報告された支出を追跡し、しきい値アラートを受け取り、設定した上限で作業を一時停止できます。	🏢 複数組織への対応 1つのデプロイで、複数の組織を運用できます。それぞれの組織で、タスク、エージェント、権限、アクティビティ履歴を分離できます。	🎫 タスクスレッド 会話、計画、ブロッカー、ファイル、実行履歴を作業に紐付けて管理できます。エージェントや人にタスクを割り当てられます。
🛡️ ガバナンス レビューと承認の段階を設定し、採用を承認できます。必要に応じて作業を一時停止、再割り当て、または停止できます。	📊 組織図 階層、役割、報告系統を設定できます。エージェントには上司、肩書き、職務記述があります。	📱 モバイル対応 どこからでも、自律型ビジネスの状況を確認し、管理できます。
🔗 アプリと接続 GitHub、Notion、Railway などのサービスや、独自の MCP サーバーに接続できます。ゲートウェイのアクションを「許可」、「事前に確認」、または「オフ」に設定できます。	👥 共有エージェントと個人アカウント 接続を利用できるユーザーと、アクセスできるエージェントを選択できます。管理対象の GitHub 操作では、作業を指示する人のアカウントを使用できます。	🧠 スキルとスキルスタジオ 共有スキルをインストールまたは作成し、保存済みの入力でテストして、結果を確認し、以前のバージョンに戻せます。
📅 スケジュール済みルーティン スケジュールに従って定期的な作業を実行したり、API や webhook を通じて起動したりできます。各実行には、タスク、担当者、履歴が記録されます。	📎 成果物とフィードバック エージェントが作成したファイルやドキュメントを見つけられます。対応形式をプレビューし、ドキュメント内の特定の箇所にコメントを残せます。	📦 すぐに使えるチーム 役割、スキル、プロジェクト、ルーティンを備えたチームをプレビューしてインストールできます。ランタイムを選び、自分に合った設定にできます。

実験的な Agent Chat と チャット／メールコネクタを使うと、Paperclip 内や、Slack、Discord、Telegram、AgentMail などの設定済みサービスを通じてエージェントと会話できます。試すには、該当するインスタンス設定を有効にしてください。

## Paperclip が解決する問題

Paperclip を使わない場合	Paperclip を使う場合
❌ Claude Code のタブを 20 個開いていて、どれが何をしているのか把握できません。再起動するとすべて失われます。	✅ タスクはチケットベースで管理され、会話はスレッドにまとめられ、セッションは再起動後も保持されます。
❌ ボットに実際の作業内容を思い出させるため、いくつもの場所から手作業でコンテキストを集めています。	✅ コンテキストはタスクからプロジェクト、会社の目標へと引き継がれるため、エージェントは何をすべきか、そしてその理由を常に把握できます。
❌ エージェント設定のフォルダーが整理されておらず、タスク管理、コミュニケーション、エージェント間の調整を一から作り直しています。	✅ Paperclip には組織図、チケット管理、委任、ガバナンスが最初から備わっているため、スクリプトの寄せ集めではなく、会社を運営できます。
❌ 暴走したループで数百ドル相当のトークンが無駄になり、何が起きたか分かる前にクォータを使い切ってしまいます。	✅ 使用状況の追跡、予算アラート、作業の自動一時停止により、進行中の作業コストを管理できます。
❌ カスタマーサポート、ソーシャルメディア、レポートなどの定期的な作業があり、手動で開始するのを忘れないようにする必要があります。	✅ ルーチンを使うと、スケジュールに沿って担当者が割り当てられたタスクが作成され、出力と実行履歴を確認できます。
❌ アイデアがあっても、リポジトリを探し、Claude Code を起動し、タブを開いたままにして、つきっきりで見守る必要があります。	✅ Paperclip にタスクを追加するだけです。コーディングエージェントが完了するまで作業します。管理者が成果をレビューします。

Paperclip が特別な理由

Paperclip は、難しいオーケストレーションの詳細を正しく処理します。

アトミックなタスクの取得。	担当者を 1 人に限定し、実行をロックすることで、複数の実行が同じタスクを奪い合うのを防ぎます。
永続的な作業コンテキスト。	タスク、コメント、ドキュメントは Paperclip に保持されます。対応するアダプターは、実行をまたいで保存済みのセッションを再開します。
実行時のスキル注入。	エージェントは再トレーニングすることなく、実行時に Paperclip のワークフローやプロジェクトのコンテキストを学習できます。
ロールバックに対応したガバナンス。	承認ゲートが適用され、設定変更はリビジョン管理されるため、問題のある変更を安全にロールバックできます。
責任を明確にした接続。	人間のアクセス、エージェントの利用資格、ゲートウェイのアクション権限は、個別に管理されます。呼び出しを一度承認するか、取り消し可能なルールとして保存できます。
目標を考慮した実行。	関連付けられたタスクとプロジェクトには目標の系譜が引き継がれるため、エージェントはタイトルだけでなく「なぜ」その作業を行うのかも把握できます。
移植可能な会社テンプレート。	シークレットの除去と競合への対処を行いながら、組織、エージェント、スキルをエクスポート／インポートできます。
組織の境界。	会社単位のアクセスチェックにより、1 つのデプロイ環境内でも各組織の作業、エージェント、アクティビティを分離できます。

## 内部の仕組み

Paperclip はラッパーではなく、完全なコントロールプレーンです。これらを自分で構築する前に、すでに実装済みであることをご確認ください。

┌──────────────────────────────────────────────────────────────┐
│                       PAPERCLIP SERVER                       │
│                                                              │
│  ┌───────────┐  ┌───────────┐  ┌───────────┐  ┌───────────┐  │
│  │Identity & │  │  Work &   │  │ Heartbeat │  │Governance │  │
│  │  Access   │  │   Tasks   │  │ Execution │  │& Approvals│  │
│  └───────────┘  └───────────┘  └───────────┘  └───────────┘  │
│                                                              │
│  ┌───────────┐  ┌───────────┐  ┌───────────┐  ┌───────────┐  │
│  │ Org Chart │  │Workspaces │  │  Plugins  │  │  Budget   │  │
│  │ & Agents  │  │ & Runtime │  │           │  │ & Costs   │  │
│  └───────────┘  └───────────┘  └───────────┘  └───────────┘  │
│                                                              │
│  ┌───────────┐  ┌───────────┐  ┌───────────┐  ┌───────────┐  │
│  │ Routines  │  │ Secrets & │  │ Activity  │  │  Company  │  │
│  │& Schedules│  │  Storage  │  │ & Events  │  │Portability│  │
│  └───────────┘  └───────────┘  └───────────┘  └───────────┘  │
└──────────────────────────────────────────────────────────────┘
         ▲              ▲              ▲              ▲
   ┌─────┴─────┐  ┌─────┴─────┐  ┌─────┴─────┐  ┌─────┴─────┐
   │  Claude   │  │   Codex   │  │   CLI     │  │ HTTP/web  │
   │   Code    │  │           │  │  agents   │  │   bots    │
   └───────────┘  └───────────┘  └───────────┘  └───────────┘

システム

アイデンティティとアクセス — 2 つのデプロイモード（信頼されたローカル環境または認証済み環境）、人間のロールと権限、エージェント API キー、有効期間の短い実行 JWT、会社への所属、招待フローを備えています。責任者の帰属情報は、委任やサポート対象の管理接続を通じて作業に引き継がれます。	組織図とエージェント — エージェントには、ロール、役職、報告ライン、権限、予算があります。アダプターの例は図に対応しています。Claude Code、Codex、Cursor／Gemini／bash などの CLI エージェント、OpenClaw などの HTTP／webhook ボット、外部アダプタープラグインです。ハートビートを受信できれば、採用できます。
作業とタスクのシステム — 課題には会社／プロジェクト／目標／親へのリンク、実行ロックを伴うアトミックなチェックアウト、第一級のブロッカー依存関係、コメント、ドキュメント、添付ファイル、成果物、ラベル、受信トレイの状態が含まれます。作業を横断検索し、ドキュメントの改訂を確認して、アンカー付きのフィードバックを残せます。	ハートビート実行 — DB によって管理されるウェイクアップキューに、集約処理、予算チェック、ワークスペース解決、シークレットの注入、スキルの読み込み、アダプターの呼び出しが備わっています。実行によって、ログ、使用記録、アダプター固有のセッション状態が生成されます。サポート対象の障害には上限付きの復旧処理で対処し、人間の対応が必要なケースを明らかにします。
ワークスペースとランタイム — プロジェクトのリポジトリとワークスペース、任意の分離された実行ワークスペース（git worktree、オペレーターのブランチ）、ランタイムサービス（開発サーバー、プレビュー URL）を備えています。サンドボックスプロバイダーにより、ローカルホスト以外でも実行できます。利用可否は、設定された環境とアダプターによって異なります。	ガバナンスと承認 — ボード承認ワークフロー、レビュー／承認の各段階を含む実行ポリシー、意思決定の追跡、予算のハードストップ、エージェントの一時停止／再開／終了が含まれます。設定されたタスクレビューによって完了を管理し、接続アクションの承認によってツールゲートウェイ経由の呼び出しを管理します。
予算とコスト管理 — 会社、エージェント、プロジェクト、目標、課題、プロバイダー、モデルごとにトークンとコストを追跡します。スコープを指定した予算ポリシーに、警告しきい値とハードストップを設定できます。適用には記録された支出を使用します。使用状況の報告や実行中の作業により、停止が遅れる場合があります。	ルーチンとスケジュール — cron、webhook、API によるトリガーを備えた定期タスクです。並行実行とキャッチアップのポリシーを設定できます。ルーチンを実行するたびに追跡対象の課題が作成され、割り当てられたエージェントが起動するため、手動で開始する必要はありません。
プラグイン — プロセス外ワーカー、機能ごとにアクセスを制御するホストサービス、ジョブのスケジューリング、ツールの公開、UI への追加機能を備えたインスタンス全体のプラグインシステムです。Paperclip をフォークせずに拡張できます。	シークレットとストレージ — 会社のシークレットと個人ごとのシークレット値、暗号化された認証情報ストレージ、ローカルまたは S3 互換のファイルストレージ、添付ファイル、成果物を備えています。シークレット参照を使うと、値を通常のエージェント設定にコピーせずに、認可された実行へ認証情報を提供できます。
アクティビティとイベント — 変更を伴う操作、ハートビートの状態変更、コストイベント、承認、コメント、成果物を永続的なアクティビティとして記録し、何が起きたのか、なぜ起きたのかを運用担当者が監査できるようにします。	会社のポータビリティ — エージェントとスキルに加えて、プロジェクト、ルーチン、タスク、添付ファイルを任意で含めた組織パッケージをプレビュー、エクスポート、インポートできます。参照されているシークレット値は除外されます。通常の環境値やローカルパスが残る場合があるため、共有する前にパッケージを確認してください。パッケージは運用環境の設定を共有するものであり、インスタンス全体の復旧にはバックアップを使用します。

## Paperclip ではないもの

単なるチャットボットではありません。	会話はタスク、計画、意思決定、成果物と紐づいたままになります。実験的な Agent Chat では、割り当て済みのタスクに作業を引き継げます。
エージェントフレームワークではありません。	エージェントの構築方法を指示するのではなく、エージェントで構成された会社の運営方法をお伝えします。
単なるワークフロービルダーではありません。	ルーティンは、役割、目標、予算、ガバナンスを備えた組織内で実行されます。
プロンプトマネージャーではありません。	エージェントはそれぞれ独自のプロンプト、モデル、ランタイムを使用します。Paperclip はエージェントが活動する組織を管理します。
単一のエージェントに限定されません。	1 つのエージェントから始め、スキルの共有、委任、レビューを行うチームへと拡大できます。
コードレビュー専用ではありません。	コーディングや PR レビューに加えて、調査、運用、コンテンツ制作などにも対応します。

クイックスタート

オープンソースで、セルフホスト可能です。Paperclip アカウントは不要です。ガイド付きクイックスタートに従って、最初のエージェントをセットアップしてください。

エージェントに Paperclip のインストールを依頼するだけ

インストールガイドをエージェントと共有してください。

または自分でインストール

Node.js 24.11 以降がインストールされている場合：

npx paperclipai@latest onboard --yes

CLI は npm のキャッシュから実行されます。インスタンスの設定とデータはローカルに保持されます。

管理されたインストール、バージョンの固定、canary および git-ref によるインストール、更新、ロールバック、サービス管理、アンインストールについては、インストールガイドをご覧ください。

CEO エージェントで初期化済みの、分離された手動テスト用インスタンスを使用するには、test-driveを使います。これはフォアグラウンドで実行され、サービスをインストールしたり最初のタスクを作成したりすることはありません。また、セットアップが成功した後にのみブラウザーを開きます。

ANTHROPIC_API_KEY=... npx paperclipai test-drive
OPENAI_API_KEY=... npx paperclipai test-drive --harness codex
OPENROUTER_API_KEY=... npx paperclipai test-drive \
  --harness opencode \
  --model openrouter/anthropic/claude-sonnet-4.5

--data-dirを指定せずに実行するたびに、一意の一時ディレクトリが作成され、保持されます。絶対パスは起動時に表示されます。ディレクトリを再利用するには--data-dirを指定し、初期化済みインスタンスを開かないようにするには--no-browserを指定してください。リンクされた Git worktree から呼び出すと、test-driveはその worktree でのタスク実行も有効にします。認証情報と再利用の動作については、test-drive ガイドをご覧ください。

トラブルシューティング：プライベート npm レジストリの.npmrc

paperclipai（または同様の名前）に対するE404で失敗し、グローバルな~/.npmrcを通じてプライベート npm レジストリ（GitHub Packages など）を使用している場合、npxがパブリック npm レジストリではなく、そのプライベートレジストリからpaperclipaiを解決している可能性があります。

診断：

npm config get registry

回避策（クロスプラットフォーム対応。このコマンドでパブリック npm レジストリを強制的に使用します）：

npx --registry https://registry.npmjs.org paperclipai@latest onboard --yes

このクイックスタートでは、最初の実行を最短にするため、信頼されたローカルループバックモードがデフォルトになりました。代わりに認証済み／プライベートモードで起動するには、バインドプリセットを明示的に選択してください。

npx paperclipai@latest onboard --yes --bind lan
# or:
npx paperclipai@latest onboard --yes --bind tailnet

Paperclip の設定がすでにある場合、onboardを再実行しても既存の設定はそのまま保持されます。設定を編集するにはnpx paperclipai configureを使用してください。

または、手動で実行します：

git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev

これにより、UI と API がhttp://localhost:3100で起動します。埋め込み PostgreSQL データベースが自動的に作成されるため、セットアップは不要です。

要件： Node.js 24.11 以上、pnpm 9.15 以上

ローカルの Claude および Codex サブスクリプションへのサインインには、Python 3 と対応するプロバイダー CLI も Paperclip ホストに必要です。Docker イメージにはこれらが含まれています。

ソースからの開発では、有効になっている場合（セルフホストのデフォルト）、ネイティブの Paperclip Runner もビルドされます。Rust ツールチェーンをインストールするか、PAPERCLIP_RUNNER_BINARYに互換性のあるビルド済みランナーを指定してください。

## よくある質問

Q: このプロジェクトはメンテナンスされていますか、それとも粗雑なだけですか？

A: Paperclip は Paperclip チームがメンテナンスしています。2,700 件を超えるプルリクエストをマージしました。

Q: 一般的なセットアップはどのようなものですか？

A: ローカルでは、単一の Node.js プロセスが組み込みの Postgres とローカルファイルストレージを管理します。本番環境では、ご自身の Postgres を指定し、お好みの方法でデプロイしてください。プロジェクト、エージェント、目標を設定すれば、あとはエージェントが対応します。

リモートアクセスには、Tailscale などのプライベートネットワークへのバインドを使った認証モードを使用するか、永続サーバーを Docker でデプロイしてください。デプロイモードとDocker ガイドをご覧ください。

Q: 複数の会社を運用できますか？

A: はい。1つのデプロイで複数の組織をホストでき、会社ごとにデータを分離してアクセスを確認できます。

Q: Paperclip は OpenClaw や Claude Code のようなエージェントと何が違いますか？

A: Paperclip はそうしたエージェントを 使用 します。組織図、予算、目標、ガバナンス、説明責任を備えた会社として、エージェントを統括します。

Q: OpenClaw を Asana や Trello に接続するだけでなく、Paperclip を使うべき理由は何ですか？

A: エージェントのオーケストレーションには、誰が作業を担当中かの調整、セッションの維持、コストの監視、ガバナンスの確立など、細かな配慮が必要です。Paperclip がこれらを担います。

（チケットシステムの持ち込みはロードマップに含まれています）

Q: エージェントは継続的に実行されますか？

A: エージェントは割り当てられた作業やフォローアップメッセージがあると起動します。任意のタイマーハートビートを設定すると、定期的に作業を確認できます。また、ルーティンを設定すると、それぞれのスケジュールに従って繰り返しタスクが作成されます。OpenClaw など、外部で実行中のエージェントを接続することもできます。メンションだけでは作業は割り当てられず、別のエージェントも起動しません。

開発

pnpm dev              # Full dev (API + UI, watch mode)
pnpm dev:once         # Full dev without file watching
pnpm dev:server       # Server only
pnpm dev:mobile       # Serve prebuilt UI on :3101 for phones/tablets (proxies /api → :3100)
pnpm dev:both         # Run `pnpm dev` and `pnpm dev:mobile` together
pnpm build            # Build all
pnpm typecheck        # Type checking
pnpm test             # Cheap default test run (Vitest only)
pnpm test:watch       # Vitest watch mode
pnpm test:e2e         # Playwright browser suite
pnpm db:generate      # Generate DB migration
pnpm db:migrate       # Apply migrations

pnpm test は Playwright を実行しません。ブラウザテストスイートは別に管理されており、通常はそのフローを開発するとき、または CI でのみ実行します。

開発ガイドの全容については、doc/DEVELOPING.mdをご覧ください。

ロードマップ

• ✅ プラグインシステム（ナレッジベース、カスタムトレーシング、キューなどを追加）
• ✅ OpenClaw / claw 系エージェントの従業員化
• ✅ companies.sh - 組織全体のインポートとエクスポート
• ✅ 簡単な AGENTS.md 設定
• ✅ スキルマネージャー、スキルスタジオ、スキルストア
• ✅ スケジュールされたルーティン
• ✅ 予算管理の改善
• ✅ エージェントのレビューと承認
• ✅ 複数の人間ユーザー
• ✅ クラウド / サンドボックスエージェント（e2b、Cloudflare、Daytona、Modal、Novita、セルフホスト可能な Kubernetes）
• ✅ 成果物と作業成果物
• ✅ 詳細な計画（計画モード、バージョン管理された計画、計画の承認）
• ✅ 成果の実現を徹底（監視役、復旧アクション、レビューチェックポイント）
• ✅ MCP ツールゲートウェイとアプリ（ガバナンスに基づくツールアクセス）
• ✅ エージェントごとのアクセス権を設定できるシークレットマネージャー
• ✅ アクティビティログとアクションの帰属
• ✅ 自己修復実行と自動復旧
• ✅ エージェント評価とフィードバック
• ✅ 接続済みアプリ
• ✅ 個人用および共有の AI アカウント
• ✅ 共有エージェントによる個人用 GitHub ID の使用
• ✅ スキルのバージョン履歴と復元
• ✅ ドキュメントのコメントと改訂履歴
• ✅ 会社全体の検索
• ✅ 複数モデルと複数ハーネスのチーム
• 🟡 メモリ / ナレッジ
• ⚪ MAXIMIZER MODE
• ⚪ 作業キュー
• ⚪ 自己組織化
• ⚪ 自動的な組織学習
• 🟡 エージェントチャット
• 🟡 クラウドデプロイ
• ⚪ デスクトップアプリ
• ⚪ チケットシステムの持ち込み（Asana / Linear / Jira を導入手段として利用）

これはロードマップの概要です。ROADMAP.mdでロードマップ全体をご覧ください。

コミュニティとプラグイン

awesome-paperclipでプラグインなどをご覧ください

オブザーバビリティ

Paperclip には、サーバー向けのオプトイン方式の OpenTelemetry 自動計装が含まれています（トレースのみ）。OTEL_EXPORTER_OTLP_ENDPOINT を設定すると有効になり、標準の OTEL_EXPORTER_OTLP_PROTOCOL 環境変数を介して grpc、http/protobuf、http/json をサポートします。@opentelemetry/api は通常のサーバー依存関係です。SDK、自動計装、エクスポーターパッケージはオプションのピア依存関係であり、トレースを利用する場合にのみインストールしてください。インストールコマンドと環境変数の全リファレンスについては、doc/observability.md を参照してください。

Paperclip には、サーバーとブラウザー向けのオプトイン方式の Sentry エラー監視も含まれています。ブラウザーで有効にするには SENTRY_DSN_FRONTEND を、サーバーで有効にするには SENTRY_DSN_BACKEND を設定します。各変数は任意であり、従来の SENTRY_DSN 変数もどちらのコンポーネントでもフォールバックとして引き続き使用できます。サポート対象のサーバー SDK バージョンは @sentry/[email protected] です。これはサーバーのオプションのピア依存関係のため、エラー監視を利用する場合にのみインストールしてください。ブラウザー SDK の @sentry/browser も、同じバージョンに固定されています。インストールコマンド、プライバシー設定、デフォルトで収集されるデータの全一覧については、doc/observability.md を参照してください。

テレメトリー

Paperclip は、製品の利用状況を把握して改善するため、匿名の利用状況テレメトリーを収集します。個人情報、イシューの内容、プロンプト、ファイルパス、シークレットは一切収集しません。プライベートリポジトリへの参照は、送信前にインストールごとのソルトを使ってハッシュ化されます。

テレメトリーイベントの送信内容を変更するコントリビューターは、テレメトリーデータコントラクトに従ってください。 生成済みコントラクトにまだ含まれていないファーストパーティイベントを提案する場合は、テレメトリーワークフローに従ってください。

テレメトリーはデフォルトで有効であり、次のいずれかの方法で無効にできます。

方法	方法
環境変数	PAPERCLIP_TELEMETRY_DISABLED=1
標準規約	DO_NOT_TRACK=1
CI 環境	CI=true の場合に自動的に無効化されます
設定ファイル	Paperclip の設定で telemetry.enabled: false を設定します

コントリビュート

コントリビュートを歓迎します。詳細については、コントリビューションガイドを参照してください。

採用情報

コミュニティ

• Discord — コミュニティに参加
• Twitter / X — 最新情報やお知らせをフォロー
• GitHub Issues — バグ報告と機能リクエスト
• GitHub Discussions — アイデアと RFC

ライセンス

MIT © 2026 Paperclip Labs, Inc

スターの推移

---

_{MITライセンスのオープンソースです。エージェントの世話ではなく、仕事を進めたい人のために作られています。}