mcpField
H
Hamster

Hamster

リモート
tryhamster.com生産性92 日前に更新
リポジトリ公式サイト

Hamster について

Hamsterは、プラグインスキルとホスト型MCPサーバーを通じて、コーディングエージェントにワークスペースの計画、タスク、ナレッジへのアクセスを提供します。CLIで計画をリポジトリに同期でき、スキルは計画、実行、テスト、レビュー、振り返りを扱います。

主な機能

  1. 01ワークスペースのブリーフ、タスク、計画、ナレッジを検索
  2. 02ワークスペース計画をリポジトリに同期
  3. 03ブリーフに基づく開発タスクの整理と実行
  4. 04テスト、コードレビュー、振り返りのスキル
  5. 05ホスト型MCPまたはCLIで対話

活用シーン

  1. 01コード変更をワークスペースの優先事項に結び付ける
  2. 02ブリーフを分析して実行計画を作成
  3. 03タスクを並行実行しコード変更を検証
  4. 04Git履歴からエンジニアリングの振り返りを作成

MCP 対応

Hamsterのホスト型MCPサーバーは`https://tryhamster.com/mcp`でワークスペースに接続し、MCP対応クライアントから利用できます。利用可能な場合、スキルは質問やワークスペース操作にMCPツールを使い、それ以外ではログイン済みCLIの`hamster chat`を使います。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://tryhamster.com/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

ツール

詳細

Hamster

Hamster をインストールします。 1 つのプラグインです。ホスト型 MCP または CLI を使って操作できます。計画をディスクに保存し、そこから実行に移します。

これが Hamster 製品です。サポート対象のすべてのクライアントで Agent Plugins のスキルを利用でき、MCP に対応し、GitHub またはマーケットプレイスからインストールできるすべてのクライアントでホスト型 MCP を利用できます。さらに、Claude Code、GitHub Copilot CLI、Grok Build では、ネイティブ実行ワーカーが生成されます。計画をこのリポジトリに保持するために CLI を使います。別途インストールするものではありません。

インストール

インストール方法はクライアントによって異なります。複数のクライアントを使う場合は、それぞれに Hamster をインストールしてください。

Cursor
  1. Customize → Add Marketplace → Import from GitHub の順に選択します。
  2. User スコープに https://github.com/gethamster/plugin を貼り付け、Import を選択します。
  3. Personal タブを開き、Hamster の横にある Add を選択します。

Enterprise では、管理者がマーケットプレイスからのインポートを許可する必要があります。Hamster が Cursor のマーケットプレイスに掲載された後は、/add-plugin hamster も使えます。

/add-plugin hamster

Grok Bot は独立した Hamster パッケージではありません。同じ Cursor アカウントとプラグインライブラリを使うため、上記の Cursor へのインストールが Grok Bot へのインストールにもなります。Grok Bot のチャットで /add-plugin を実行しないでください。Grok Bot に「Complete GitHub auth to sync installed plugins」と表示された場合は、Grok Bot の指示に従って GitHub 認証を完了してください。

Claude Code
/plugin marketplace add gethamster/plugin
/plugin install hamster@hamster-plugins
Codex CLI
codex plugin marketplace add gethamster/plugin
codex plugin add hamster@hamster-plugins

codex を起動し、/plugins を実行して、hamster@hamster-plugins をインストールすることもできます。

Codex Plugins Directory

OpenAI の Plugins Directory に掲載されている Hamster は、Codex と ChatGPT で使用されます。この掲載物は、node scripts/build-codex-bundle.mjs によって生成される同じプラグインの zip です。内容は、Codex マニフェスト、.mcp.json 内のホスト型 MCP コネクター、スキル、掲載用画像です。CI はプッシュのたびにこれをビルドしてワークフローのアーティファクトとしてアップロードします。アーティファクトをダウンロードすると、ディレクトリにアップロードする zip を入手できます。

1 つのセクションは異なります。zip では skills/setup/SKILL.md の「Install the CLI」セクションが codex-directory/install-cli.md に置き換わります。CLI が見つからない場合、セットアップではインストーラーを実行せず、CLI binary から自分でインストールするよう案内します。その後、通常どおりサインインして同期します。

Hamster はホスト型 MCP サーバーを介してワークスペースに接続します。コーディングスキルには、リポジトリとシェルへのアクセスが必要です。

Antigravity

このリポジトリをクローンした状態から:

agy plugin install ./plugins/hamster

または GitHub から:

agy plugin install https://github.com/gethamster/plugin/plugins/hamster

どちらの方法でも、他のすべてのクライアントがインストールするフォルダー plugins/hamster にインストールされます。リポジトリのルート URL を直接指定する方法も使えますが、その場合 agy はルートを Gemini CLI 拡張機能としてインポートし、エージェントのモデル設定を削除します。上記のコマンドを実行すると、そのインストールをそのまま置き換えられます。

Hamster 3.2 がすでにインストールされている場合は、3.4 をインストールする前にアンインストールしてください。Antigravity に上書きインストールすると、3.4 で名前が変更された 4 つのスキルディレクトリが残ります。

agy plugin uninstall hamster
agy plugin install https://github.com/gethamster/plugin/plugins/hamster

Antigravity アプリ(2.15 以降)で、Settings → Customizations → Installed MCP Servers から hamster_hamster を認証します。プラグインがこのサーバーを登録するため、mcp_config.json に手動で hamster を追加すると、すべてのツールが重複して登録されます。

GitHub Copilot CLI、Gemini CLI、Grok Build、OpenCode、Pi をお使いですか?その他のインストール方法をご覧ください。

その他のインストール方法

GitHub Copilot CLI
copilot plugin marketplace add gethamster/plugin
copilot plugin install hamster@hamster-plugins

ホスト型 MCP サーバーにサインインするには、/mcp auth hamster を実行します。

Gemini CLI
gemini extensions install https://github.com/gethamster/plugin

ホスト型 MCP サーバーにサインインするには、/mcp auth hamster を実行します。

Grok Build
grok plugin install gethamster/plugin --trust

ホスト型 MCP サーバーにサインインするには、/mcps を開いて hamster を選択し、i を押します。

OpenCode

OpenCode では、スキルとホスト型 MCP サーバーを 2 つの手順で設定します。プロジェクトフォルダーで次のコマンドを実行します。

npx skills add gethamster/plugin --agent opencode
opencode mcp add hamster --url https://tryhamster.com/mcp

npx skills add に --global を追加すると、現在のプロジェクトではなく ~/.agents/skills/ にインストールされます(opencode mcp add --url には OpenCode 1.17.0 以降が必要です)。

ホスト型 MCP サーバーにサインインするには、opencode mcp auth hamster を実行します。

Pi
pi install npm:@tryhamster/pi

npm のリリースではなくリポジトリを追跡するには、pi install git:github.com/gethamster/plugin を実行します。

Pi パッケージがインストールするのはスキルのみです。ホスト型 MCP サーバーに接続するには、追加してサインインします。

pi mcp add hamster --url https://tryhamster.com/mcp
pi mcp login hamster

インストール後

  1. 会話する — https://tryhamster.com/mcp のホスト型 MCP を使います。MCP ツールが利用できず、CLI にサインイン済みの場合は hamster chat を使います。Hamster へのサインインはクライアントが管理します。
  2. プランをディスク上に保存する — Install Hamster と伝えるか、ship を実行します。セットアップスキルは、必要に応じて CLI をインストールし、hamster auth login を実行して、プランを同期します。
  3. 出荷する — ディスク上にあるブリーフを実行します。セッション開始時に自動実行されるものはありません。

スキル

Claude Code と Copilot CLI では、これらは /hamster:<skill> として一覧表示されます。Cursor と Grok Build では /<skill>、Pi では /skill:<skill> として一覧表示されます。OpenCode では名前を指定して依頼するか、OpenCode 2 では @setup として言及します。表では Claude 形式を使用しています。

スキルペルソナ説明
/hamster:setup—CLI をインストールし、サインインして、このリポジトリにプランを同期します
/hamster:ask-hamster [request]ワークスペースコパイロット現在のコードをワークスペースの優先事項、ブロッカー、ブループリント、または関連する作業に結び付けます(クライアントが対応している場合はホスト型 MCP、それ以外の場合は hamster chat)
/hamster:ship [brief]リリースエンジニアブリーフを出荷します:ベースブランチをマージし、並行して実装し、テスト、レビュー、二分探索可能なコミット、PR を行います
/hamster:plan-hamster [brief]テックリード + CEO/エンジニアリングモード任意の創業者レビューまたはアーキテクチャレビューを含めてブリーフを分析します
/hamster:resume-hamster [brief]—中断した実行を、前回終了したところから再開します
/hamster:review-hamsterスタッフエンジニア2 段階の慎重なコードレビュー(CRITICAL、次に INFORMATIONAL)
/hamster:qa [mode]QA リード差分対応、全体、簡易、リグレッションの体系的なテスト
/hamster:retro [days]エンジニアリングマネージャーメトリクス、傾向、チーム分析を含むエンジニアリングの振り返り

Cursor はプラグインスキルを /skill-name の形式で呼び出します。また、ask、plan、resume は Cursor 独自の概念です。cursor-agent --mode では plan と ask を指定し、--resume ではセッションを選択するため、短い名前を使うと Cursor 上で競合します。このため、review も同じ命名規則に合わせて変更し、Cursor のコマンド一覧で規則を統一しています。Claude Code ではプラグインスキルが /<plugin>:<skill> の形式で名前空間化され、競合しないため、Claude では接尾辞は冗長で、/hamster:ask-hamster と入力します。すべてのクライアントで同じスキルツリーを使うため、Cursor で曖昧さを避けるにはこの代償が必要です。ship、qa、retro、setup は何とも競合しないため、短い名前のままです。

/hamster:setup

準備状況を整えるための手順です。まず非対話型チェック(ensure-ready)を行います。CLI がインストール済みでサインインも済んでいる場合は、プランを更新するために hamster sync を実行します。それ以外の場合は、CLI をインストールし、ログイン画面を開いて、init/同期を行います。これらは依頼された場合にのみ実行します。

/hamster:ask-hamster

ワークスペース全体にわたる Hamster の判断が必要な自由形式の質問への窓口です。たとえば、変更中のコードが優先事項、ブループリント、決定事項とどのように関連しているかを尋ねる場合に使います。クライアントが利用できる場合は ask_hamster MCP ツールを通じて質問します。それ以外の場合は、CLI 経由で同じ質問手順を行う hamster chat を使います。直接の読み取りと書き込みには、代わりに名前を指定して Hamster MCP ツールを使います。例:

/hamster:ask-hamster I'm modifying auth middleware in apps/web/app/api/. What does our blueprint say about third-party integrations?
/hamster:ask-hamster I prototyped rate limiting in apps/api/middleware/rate-limit.ts. Which brief or initiative should this work belong to?

前の回答に基づく追加の質問では、同じ Hamster の会話を続けます。

/hamster:ship

メインのオーケストレーターです。ship、plan-hamster、resume-hamster では、共通のブリーフ選択ロジックを使用します。まずスラッグ、UUID、または Hamster Studio の URL が優先され、次に完全一致するタイトルまたは短いタイトル(サブタイトル区切り文字より前の部分)が使われます。名前では、大文字と小文字、先頭の「the」、末尾の「brief」、末尾の句読点は無視されます。一意に一致すれば選択を求めずに進みます。一致候補が複数ある場合や、部分一致しかない場合は、確認を求めます。

/hamster:ship user-authentication
/hamster:ship the Checkout reliability brief.
/hamster:ship https://tryhamster.com/home/hamster/briefs/2de8d546-50ab-4dbd-a678-579ec8119f60

引数を指定しない場合は、実行可能なブリーフのインタラクティブな選択画面を表示します。

フロー:準備状況の確認(セットアップ/準備完了の確認)→ セットアップ(前提条件+ライブ同期)→ ブリーフの選択 → インラインでのウェーブスケジュール設定(確認は1回)→ ブランチ+マージベース → ウェーブの並列実行(実装 → 検証+テスト → ウェーブレビュー → 二分探索可能なコミット)→ 最終検証 → PR 作成について確認

どのステップでも計画の生成やタスクの詳細化は行われません。スケジュール設定では、事前に生成されたタスクを並列ウェーブに整理するだけです。

/hamster:plan-hamster

任意の詳細レビューを含む、読み取り専用の分析です。変更を加えずに実行計画を作成します。

/hamster:plan-hamster api-rate-limiting

分析後、レビュー形式を選択します。

  • CEO レビュー(創業者モード) — 第一原理から掘り下げる10セクションの詳細レビュー
  • エンジニアリングレビュー(アーキテクチャモード) — ASCII 図とテスト計画を含む4セクションの技術レビュー
  • クイック分析 — 計画のみ
/hamster:resume-hamster

中断された実行を再開します。git ブランチ名(feature/{key}-{id}-{slug})、進行中のタスク、または指定された引数からブリーフを自動検出します。

/hamster:resume-hamster
/hamster:resume-hamster user-authentication
/hamster:review-hamster

現在の機能ブランチに対する、慎重な2段階のコードレビューです。

  • パス1(重大):SQL の安全性、競合状態、認証境界、列挙型の網羅性、シークレット
  • パス2(参考情報):副作用、マジックナンバー、デッドコード、テスト不足、型変換、時間の安全性
  • 重大な指摘事項に対して、修正/確認済みとして処理/誤検出の選択肢を用意した対話形式の対応
/hamster:review-hamster
/hamster:qa

4つのモードによる体系的なテストです。

/hamster:qa diff        # Test only what changed (default on feature branches)
/hamster:qa full        # Full test suite with coverage
/hamster:qa quick       # 30-second lint + typecheck + smoke tests
/hamster:qa regression  # Changed files + dependents, flag new failures

問題の分類(機能/型安全性/統合/パフォーマンス/カバレッジ不足)と、任意の修正ループが含まれます。

/hamster:retro

git 履歴に基づくエンジニアリングの振り返りです。

/hamster:retro          # Last 7 days (default)
/hamster:retro 14       # Last 14 days
/hamster:retro 30       # Last 30 days
/hamster:retro 24h      # Last 24 hours

出力内容:メトリクス表、時間帯別の分布、セッション分析、ホットスポット、PR の規模、称賛と成長に向けた提案を含むコントリビューターごとの詳細分析、前回の振り返りとの傾向比較、概要のまとめ。

実行ワーカー
ワーカーペルソナ目的
task-executorシニアエンジニア1つの親タスクとそのサブタスクを実装します。プロジェクトのスキル、ブループリント、手法を読み込みます
wave-reviewerスタッフエンジニアウェーブ全体の差分をレビューします(親タスクごとの判定+親タスク間の統合チェック)。その後、簡素化します

標準ワーカープロトコルは plugins/hamster/skills/ship/references/agents/ にあります。plugins/hamster/agents/task-executor.md と plugins/hamster/agents/wave-reviewer.md は、それらの本文を基に生成されるネイティブアダプター(登録+モデルメタデータ)です。Gemini CLI(およびリポジトリの URL をそのまま指定する場合の Antigravity)を除くすべてのクライアントは、この1つのフォルダーから登録します。これらのクライアントでは、モデルメタデータなしで、生成されたルートの agents/ コピーを登録します。標準ファイルを編集した後は node scripts/sync-adapters.mjs を実行してください。CI で差異がチェックされます。クライアントがネイティブエージェントを公開している場合(Claude Code、Copilot CLI、Grok Build が該当)、Ship は登録済みのネイティブエージェントを優先します。そうでない場合は、汎用サブエージェントを起動して対応する標準本文を挿入し、それもできない場合は同じプロトコルをインラインで実行します。汎用サブエージェントを使う場合、クライアントがモデルを指定できるなら、task-executor には利用可能な最も高性能なコーディングモデルを、wave-reviewer には中位のモデルを優先してください。指定できない場合は、既定のモデルを使用します。ウェーブのスケジュール設定、ブランチの作成、コミット、PR の作成はインラインのままです。 エグゼキューターは、矛盾するタスクよりも明確なブリーフ/仕様を優先し、解決済みの計画上の問題を記録します。未解決または未実装の作業のみが完了を妨げます。PRを再開して更新する際も、以前に解決したタスクと計画フィードバックの内容は維持されます。

各スキルディレクトリは自己完結しています。クライアントはスキルを単独でインストールまたは読み込む場合があるため、どの SKILL.md も別のスキルのファイルを読み込みません。各スキルは SKILL.md と、任意の scripts/ および references/ で構成されます。クライアントのサイズ制限内にスキル本文を収めるため、長い手順は references/ に置きます(Codex が読み込むのは最初の 8,000 バイトです)。各スキルの scripts/ にある準備状況スクリプトや、plan-hamster と resume-hamster が再度読み込む references/ 内のプロトコルなど、共通の内容は必要とするすべてのスキルに複製します。scripts/validate-plugin.mjs は各コピーのハッシュを計算し、内容に差異がある場合はビルドを失敗させます。ルートの scripts/ は保守用ツール(sync-adapters.mjs、validate-plugin.mjs、build-codex-bundle.mjs)であり、インストールされるプラグインには含まれません。

plugins/hamster/ がプラグインです。以下で説明するルートの生成済みコピーをインストールする Gemini CLI を除き、すべてのクライアントがこのフォルダーをインストールします。Claude プラグインディレクトリへの提出対象となるフォルダーであり、同ディレクトリは渡されたフォルダーのみをスキャンします。このフォルダーには各クライアントのマニフェスト(.claude-plugin/、.codex-plugin/、.cursor-plugin/、および Antigravity が読み込む plugin.json)、.mcp.json と Antigravity が読み込む mcp_config.json、skills/、agents/、そしてプラグインが実行、送信、取得する内容を記載した独自の README.md が含まれます。内容を変更した場合は、この README も更新してください。リポジトリのルートには、./plugins/hamster を参照するマーケットプレイスカタログ(Copilot CLI も読み込む .claude-plugin/、.cursor-plugin/、.agents/plugins/)、Pi に同じスキルを認識させる pi.skills を設定したルートの package.json、Gemini 用の生成された拡張機能、保守用ツール、CI、掲載用画像が置かれています。validate-plugin.mjs は、他のプラグインマニフェストや MCP 設定がルートにあると失敗します。これは、Antigravity がリポジトリの URL を直接指定された場合にルートをインストールして、そのファイルを読み込むためです。また、.claude-plugin/icon.svg を除き、plugins/hamster/ 内にシンボリックリンクまたは画像があると失敗します。.claude-plugin/icon.svg は Claude プラグインディレクトリの掲載用アイコンであり、ラスター画像、スクリプト、外部参照を含まない自己完結型 SVG のままにする必要があります。さらに、assets/ 内の Codex 掲載用 PNG 3 点は、ルートの assets/ 内のコピーとバイト単位で一致している必要があります。build-codex-bundle.mjs はルートの assets/ を OpenAI Plugins Directory の zip にまとめます。Cursor のロゴには、ルートの assets/logo.svg の URL を指定します。この plugin.json で Agent Plugins の $schema を宣言してはいけません。宣言すると、Copilot CLI は com.github.copilot/agents/ からしかエージェントを読み込まず、どちらのワーカーも登録しなくなります。

生成された gemini-extension.json に加えて、ルートに置かれる唯一のプラグインマニフェストは .grok-plugin/plugin.json です。Grok Build の plugin install <repo> はリポジトリのルートにあるマニフェストを読み込み、マーケットプレイスカタログは参照しないため、このファイルでは skills、agents、mcpServers の場所を plugins/hamster/ 内に指定します。これにより、grok plugin install gethamster/plugin --trust が引き続き動作し、既存の Grok インストールをこのレイアウトに更新できます。Grok はファイルの配列からエージェントを読み込まないため、agents はディレクトリパスのままにする必要があります。sync-adapters.mjs は plugins/hamster/plugin.json から名前、バージョン、説明を書き込み、validate-plugin.mjs は各パスが解決されることと、他の <client>-plugin/plugin.json がルートに存在しないことを検証します。Antigravity と Pi は .grok-plugin/ を読み込まず、Claude プラグインディレクトリがスキャンするのは plugins/hamster/ のみです。 ルートの skills/、agents/、gemini-extension.json は編集しないでください。 これらは Gemini CLI 拡張機能であり、sync-adapters.mjs が plugins/hamster/ から生成します。skills/ は完全なコピーで、agents/ では Gemini が拒否する color 行と、Gemini モデル名として読み取られる model 行を除外し、gemini-extension.json では名前、バージョン、説明を plugins/hamster/plugin.json から、ホストされている MCP URL を plugins/hamster/.mcp.json から取得します。Gemini CLI 拡張機能ギャラリーでは、ルートにこのマニフェストがあるリポジトリが一覧表示され、Gemini はその隣にあるスキルとエージェントのみを読み込みます。リポジトリの URL だけで、Antigravity は同じルートをインストールし、同じ 8 個のスキル、2 個のエージェント、MCP サーバーを取得します。plugins/hamster/ を編集し、node scripts/sync-adapters.mjs を実行して、両方をコミットしてください。ルートのコピーにずれがあると、--check とバリデーターが失敗します。

ルートの package.json は Pi パッケージです。Pi はリポジトリをルートからインストールするため、pi.skills は Pi を plugins/hamster/skills に導きます。同じファイルが公開 npm パッケージ @tryhamster/pi でもあります。pi-package キーワードが含まれており、Pi のパッケージカタログはこれを使って npm パッケージを検索します。また、files ではスキルのみが配布されます。npm がこの README、LICENSE、package.json を追加します。sync-adapters.mjs はこれを plugins/hamster/plugin.json から書き出すため、プラグインのバージョンを上げると新しい npm バージョンになります。ずれがある場合、非公開になった場合、キーワードがなくなった場合、またはスキルが配布されなくなった場合は、validate-plugin.mjs が失敗します。リリースを公開するには、npm pack --dry-run を実行してファイル一覧を確認し、その後、リポジトリのルートから npm publish --access public を実行してください。

共有素材の編集には、複数ファイルの編集が必要です。 以下の各グループでは、最初のパスが正本で、それ以外はバイト単位で同一に保つ必要があるコピーです。正本を変更して、ほかのファイルにコピーしてから、バリデーターを実行してください。グループにずれがある場合、正確な cp コマンドが表示されます。

正本コピー
plugins/hamster/skills/setup/scripts/ensure-ready.shship、plan-hamster、resume-hamster
plugins/hamster/skills/setup/scripts/ensure-ready.ps1ship、plan-hamster、resume-hamster
plugins/hamster/skills/ship/references/brief-selection.mdplan-hamster、resume-hamster
plugins/hamster/skills/ship/references/execution-loop.mdresume-hamster
plugins/hamster/skills/ship/references/agents/task-executor.mdresume-hamster
plugins/hamster/skills/ship/references/agents/wave-reviewer.mdresume-hamster
実行ループ

並列実行される、互いに依存しない親タスクの各ウェーブについて:

Wave N (parallel):
  [task-executor A] || [task-executor B] || [task-executor C]

Post-wave (orchestrator):
  Validation + test gate (one pass, stop on test failure)
  [wave-reviewer] — one worker for the whole wave
    (small low-risk waves: orchestrator reviews inline, no worker)
  Bisectable commits per parent (direct bash)
Git の規約
  • ブランチ:feature/{key}-{lowest-id}-{brief-slug}。{key} はタスクの表示 ID のキーを小文字にしたものです(HAM-42 → feature/ham-42-…、ACME-7 → feature/acme-7-…)
  • 親タスクのコミット:feat({key}-123): concise description(バイセクトしやすいよう、関心ごとに分割)
  • 簡素化のコミット:refactor({key}-123): simplify description
  • レビュー修正のコミット:fix({key}-123): address review findings
  • QA 修正のコミット:fix(qa): test-file — description
  • PR:リクエストに応じて作成(自動作成はされません)。検出されたデフォルトブランチをターゲットにします

上級者向け:CLI バイナリ

プラグインクライアントを使わずに hamster バイナリを使いたい場合に使用します。Plugins Directory からのセットアップでこのページに移動してきた場合は、インストール行のみを実行するか(または以下からバイナリをダウンロードして PATH に配置して)、セットアップに戻ってください。サインインと同期が行われます。

curl -fsSL https://tryhamster.com/cli/install | bash
hamster auth login
hamster init
hamster sync

または、最新リリースからバイナリをダウンロードしてください。

対応プラットフォーム:macOS(amd64、arm64)、Linux(amd64、arm64)、Windows(amd64)。

このリポジトリ内のプラグインパッケージとソースファイルは MIT ライセンスで提供されています。GitHub Releases を通じて配布されるビルド済みの hamster バイナリは、Hamster の商用利用規約に基づいて提供されます。

CLI コマンド
コマンド説明
hamster auth loginブラウザー経由で認証します(OAuth 2.1 + PKCE)
hamster auth logoutログアウトし、保存された認証情報を消去します
hamster initHamster のデータを初期化し、最初の同期を実行します
hamster syncHamster Studio から一度だけ同期します
hamster sync --watchWebSocket 経由でリアルタイムに継続同期します
hamster chat "<request>"ターミナルから Hamster に依頼します(追加の依頼には --continue を指定)。プラグインのツールを利用できない場合、ホスト型 MCP と同じ依頼経路を使用します
hamster status同期ステータスと統計情報を表示します(プレーンな出力には hamster --no-tui status を使用します。これはスキルの準備状況ゲートで実行されます)
hamster task status <id> <status>タスクのステータスを更新します(todo、in_progress、done)
hamster brief status <slug> <status>ブリーフのステータスを更新します
同期される内容

スキルは現在のリポジトリ内の .hamster/ を読み取ります。

.hamster/
  .state.json      # Sync metadata (don't edit)
  {account}/
    briefs/
      {brief-slug}/
        brief.md     # The brief itself
        tasks/       # Parent tasks and subtasks
    blueprints/      # Architecture documents
    methods/         # Team conventions

スキルは .state.json の account_slug からアカウントディレクトリ名を取得します。HAMSTER_ACCOUNT_ID にはアカウント UUID が格納されるため、設定されている場合、スキルはこれを account_id と照合し、推測で処理を進めずに停止します。

ホスト型 MCP ツールは、ユーザーごとに有効なチームを 1 つ対象とし、リポジトリとは結び付いていません。そのため、最初の Hamster MCP 呼び出しの前、および各依頼や変更の前に、ask-hamster はこのリポジトリの account_slug(ここで最後に hamster sync を実行した時点の CLI チーム)を指定して switch_account を呼び出し、切り替え先のチームの account_id が一致することを確認します。そうしないと、複数のチームに所属するユーザーが、実在するタスクに対して「見つかりません」と表示されることがあります。サーバーはこの選択をユーザーごとに保存するため、切り替えると、他の Hamster MCP クライアントが使用するチームも、再度切り替えるまで変更されます。切り替えに失敗した場合、または別のチームに切り替わった場合、スキルは停止し、hamster init --force を実行するか、適切な MCP サインインを行うよう案内します。他のスキルは Hamster MCP ではなく CLI を使用するため、チームを切り替えません。

上級者向け:プラグインなしでホスト型 MCP を使用する

プラグインをインストールせずに、クライアントでホスト型 MCP ツールを使いたい場合にのみ使用してください。リモート MCP コネクターとして https://tryhamster.com/mcp を追加し、OAuth でサインインしてください。セットアップ方法、ツール一覧、クライアント登録については、MCP サーバーのドキュメントをご覧ください。スキル、スラッシュコマンド、CLI、/ship はプラグインに含まれています。


ライセンス

MIT。Copyright Wheel Go Fast, Inc. Hamster によるデータの取り扱いについては、Hamster のプライバシーポリシーをご覧ください。MIT ライセンスの許諾対象は、このリポジトリ内のプラグインパッケージとソースファイルです。GitHub Releases で配布されるビルド済みの hamster バイナリには、Hamster の商用利用規約が適用されます。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。