mcpField
O
openpets

openpets

github.com/alvinunrealその他4283 回インストール5 週間前に更新
リポジトリ

openpets について

OpenPets は、コーディングエージェント向けのローカルデスクトップアプリで、CLI、MCP、フック、プラグイン、ローカル IPC からペットを操作できます。このスキルは、導入やペット・エージェントの設定、検証、問題の切り分けを案内します。

主な機能

  1. 01複数のインターフェースからペットを操作
  2. 02公開カタログからペットをインストール
  3. 03コーディングエージェントと MCP クライアントを設定
  4. 04プロジェクトにペットを割り当て
  5. 05ツールの検証と設定のトラブル対応

活用シーン

  1. 01コーディングエージェントにペットを設定
  2. 02プロジェクトでインストール済みのペットを選択
  3. 03MCP ツールの利用可否を確認
  4. 04デスクトップアプリ連携の問題を解決

MCP 対応

OpenPets は MCP サーバーを提供し、MCP クライアントからペット操作ツールを呼び出せます。リアルタイム操作にはデスクトップアプリのインストールと起動が必要です。

インストール

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

$npx skills add https://github.com/alvinunreal/openpets --skill openpets

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
commands.md
config-files.md
integrations.md
source-docs.md
workflows/
configure-project.md
explain-architecture.md
install-openpets.md
install-pet.md
troubleshoot.md
verify-claude.md
verify-mcp.md
verify-opencode.md

詳細

OpenPets

OpenPets は、コーディングエージェント向けのデスクトップコンパニオンアプリです。デスクトップアプリはローカルで動作し、CLI、MCP、フック、プラグイン、ローカル IPC を通じてペットを操作できます。

このスキルを使って、ユーザーがすばやく安全に使い始められるよう支援します。

  • OpenPets デスクトップアプリをインストールする、またはインストール済みか確認する
  • 公開カタログからペットをインストールする
  • Claude Code、OpenCode、Cursor、Codex、またはその他の MCP クライアントを設定する
  • 特定のペットを使うようにプロジェクトを設定する
  • openpets_status、openpets_react、openpets_say を検証する
  • OpenPets の仕組みを説明する
  • セットアップの問題をトラブルシューティングする

CLI のルール：最初に一度だけインストールし、その後は openpets を使用する

最も簡単に使い始められるよう、まず OpenPets CLI をグローバルにインストールします。

npm install -g @open-pets/cli

その後、openpets コマンドを使用します。

openpets <command>

グローバルインストールを希望しない場合、CI 環境の場合、または一度限りのコマンドだけが必要な場合は、代わりに次の方法を使用します。

npx -y @open-pets/cli@latest <command>

MCP サーバーの設定には、専用の MCP パッケージを使用してください。

npx -y @open-pets/mcp@latest --pet <pet-id>

デスクトップアプリをインストールすればシェルコマンドも自動的にインストールされると説明してはいけません。openpets コマンドは、オプションの npm グローバル CLI インストールによって提供されます。

基本的な考え方

Claude/OpenCode/Codex/Cursor/MCP client
  -> OpenPets MCP, plugin, hook, or CLI
  -> @open-pets/client
  -> local IPC discovery/token
  -> OpenPets desktop app
  -> default pet or selected agent pet lease

ペットをリアルタイムに操作するには、OpenPets デスクトップアプリがインストールされ、実行中である必要があります。

判断ツリー

  • OpenPets のインストールについて尋ねられた場合：workflows/install-openpets.md に従います。
  • ペットのインストールについて尋ねられた場合：workflows/install-pet.md に従います。
  • プロジェクトまたはエージェントの設定について尋ねられた場合：workflows/configure-project.md に従います。
  • Claude Code の検証について尋ねられた場合：workflows/verify-claude.md に従います。
  • OpenCode の検証について尋ねられた場合：workflows/verify-opencode.md に従います。
  • MCP またはツールの利用可否について尋ねられた場合：workflows/verify-mcp.md に従います。
  • 問題が発生したと報告された場合：workflows/troubleshoot.md に従います。
  • OpenPets の仕組みについて尋ねられた場合：workflows/explain-architecture.md に従います。

安全上のルール

  • MCP／プラグイン／フックの設定を手動で編集するより、OpenPets の公式 CLI／UI の手順を優先します。
  • --force の使用や、ユーザーが管理する既存の MCP／プラグイン／フック設定の置き換えを行う前に、確認を求めます。
  • プロジェクト固有の設定を行う前に、プロジェクトのパスを確認します。
  • ペットをインストールまたは選択する前にペット ID を確認し、プロジェクトで使うよう設定する前に、そのペットがインストール済みであることを確かめます。
  • ペットの発話に、秘密情報、非公開ログ、非公開パス、ソースコード、URL、認証情報、機密性の高いテキストを含めてはいけません。
  • 設定を変更した後は、Claude Code、OpenCode、またはその他の MCP クライアントを再起動します。
  • デスクトップアプリがインストール済み、または実行中だと断言せず、確認してください。
  • 通常のトラブルシューティングを行ってもセットアップに失敗する場合は、OpenPets GitHub リポジトリでバグを報告するようユーザーに勧めます：https://github.com/alvinunreal/openpets/issues

基本的なクイックコマンド

npm install -g @open-pets/cli
openpets status
openpets pets
openpets install <pet-id>
openpets configure --agent claude --pet <pet-id> --cwd <project-path> --yes
openpets configure --agent opencode --pet <pet-id> --cwd <project-path> --yes
openpets configure --agent cursor --pet <pet-id> --cwd <project-path> --yes
openpets mcp --pet <pet-id>

一度限りの代替方法：openpets を npx -y @open-pets/cli@latest に置き換えます。

MCP サーバーのコマンド：

npx -y @open-pets/mcp@latest --pet <pet-id>

公開リソース

詳細が変更されている可能性がある場合は、openpets.dev のドキュメントを信頼できる情報源として参照してください。

コメント

Markdown 対応