Hamster について
Hamsterは、プラグインスキルとホスト型MCPサーバーを通じて、コーディングエージェントにワークスペースの計画、タスク、ナレッジへのアクセスを提供します。CLIで計画をリポジトリに同期でき、スキルは計画、実行、テスト、レビュー、振り返りを扱います。
主な機能
- 01ワークスペースのブリーフ、タスク、計画、ナレッジを検索
- 02ワークスペース計画をリポジトリに同期
- 03ブリーフに基づく開発タスクの整理と実行
- 04テスト、コードレビュー、振り返りのスキル
- 05ホスト型MCPまたはCLIで対話
活用シーン
- 01コード変更をワークスペースの優先事項に結び付ける
- 02ブリーフを分析して実行計画を作成
- 03タスクを並行実行しコード変更を検証
- 04Git履歴からエンジニアリングの振り返りを作成
MCP 対応
Hamsterのホスト型MCPサーバーは`https://tryhamster.com/mcp`でワークスペースに接続し、MCP対応クライアントから利用できます。利用可能な場合、スキルは質問やワークスペース操作にMCPツールを使い、それ以外ではログイン済みCLIの`hamster chat`を使います。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://tryhamster.com/mcpclaude mcp add --transport http gethamster-hamster https://tryhamster.com/mcp{"mcpServers":{"gethamster-hamster":{"type":"http","url":"https://tryhamster.com/mcp"}}}Cursor で開く{"servers":{"gethamster-hamster":{"type":"http","url":"https://tryhamster.com/mcp"}}}VS Code で開く{"mcpServers":{"gethamster-hamster":{"type":"http","url":"https://tryhamster.com/mcp"}}}{"mcpServers":{"gethamster-hamster":{"serverUrl":"https://tryhamster.com/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
Hamster
Hamster をインストールします。 1 つのプラグインです。ホスト型 MCP または CLI を使って操作できます。計画をディスクに保存し、そこから実行に移します。
これが Hamster 製品です。サポート対象のすべてのクライアントで Agent Plugins のスキルを利用でき、MCP に対応し、GitHub またはマーケットプレイスからインストールできるすべてのクライアントでホスト型 MCP を利用できます。さらに、Claude Code、GitHub Copilot CLI、Grok Build では、ネイティブ実行ワーカーが生成されます。計画をこのリポジトリに保持するために CLI を使います。別途インストールするものではありません。
インストール
インストール方法はクライアントによって異なります。複数のクライアントを使う場合は、それぞれに Hamster をインストールしてください。
Cursor
- Customize → Add Marketplace → Import from GitHub の順に選択します。
- User スコープに
https://github.com/gethamster/pluginを貼り付け、Import を選択します。 - 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
インストール後
- 会話する —
https://tryhamster.com/mcpのホスト型 MCP を使います。MCP ツールが利用できず、CLI にサインイン済みの場合はhamster chatを使います。Hamster へのサインインはクライアントが管理します。 - プランをディスク上に保存する — Install Hamster と伝えるか、ship を実行します。セットアップスキルは、必要に応じて CLI をインストールし、
hamster auth loginを実行して、プランを同期します。 - 出荷する — ディスク上にあるブリーフを実行します。セッション開始時に自動実行されるものはありません。
スキル
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.sh | ship、plan-hamster、resume-hamster |
plugins/hamster/skills/setup/scripts/ensure-ready.ps1 | ship、plan-hamster、resume-hamster |
plugins/hamster/skills/ship/references/brief-selection.md | plan-hamster、resume-hamster |
plugins/hamster/skills/ship/references/execution-loop.md | resume-hamster |
plugins/hamster/skills/ship/references/agents/task-executor.md | resume-hamster |
plugins/hamster/skills/ship/references/agents/wave-reviewer.md | resume-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 init | Hamster のデータを初期化し、最初の同期を実行します |
hamster sync | Hamster Studio から一度だけ同期します |
hamster sync --watch | WebSocket 経由でリアルタイムに継続同期します |
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 の商用利用規約が適用されます。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。