helmor-cli

Helmor CLI

シンプルなターミナル中心の Helmor ワークフローを進める際に、このスキルを使用します。実用性を重視し、長い CLI チュートリアルではなく、具体的なコマンドを 1 つか 2 つ提示してください。

コマンドの振り分け

/helmor-cli の後に続く最初の単語で振り分けます。

• restack — 下位のレイヤーが変更またはマージされた後に、PR スタックを再同期します。references/restack.md に従ってください。（これはコンポーザーの Restack ボタンが送信する内容です。）
• stack — 大規模な変更を依存関係のある PR のスタックとして計画し、構築します。references/stacked-pr.md に従ってください。
• break — 現在のワークスペースですでに作成済みの変更を、より小さな依存関係のある PR のスタックに分割します。まず、分割の粒度をユーザーに確認してください。references/break.md に従ってください。
• その他（または引数なし）— 通常の Helmor CLI タスクです。以下のバイナリ名のガイダンスとコマンドリファレンスを使用してください。

バイナリ名（リリース版と開発版）

以下の例では、リリース版のユーザーが PATH 上で使用できるバイナリ名 helmor をそのまま使用しています。

• リリースビルド：helmor <subcommand> の形式でコマンドを実行します。
• 開発ビルド：PATH 上に helmor-dev があると想定しないでください。Helmor の worktree ベースの開発ワークフローでは、各 worktree に専用の target/debug/helmor-cli があり、共有の /usr/local/bin/helmor-dev シンボリックリンク（存在する場合）から参照できるのは、そのうち 1 つだけです。そのため：
  • Helmor 内で実行するエージェントの場合、システムプロンプトですでに使用すべき正確な CLI の呼び出し方法が渡されています（通常は <worktree>/src-tauri/target/debug/helmor-cli のような絶対パスです）。そのまま呼び出してください。which／file／--version で再確認しないでください。
  • ターミナルを使用する人間の場合は、<your-worktree>/src-tauri/target/debug/helmor-cli <subcommand> を実行します（または、アクティブな Helmor ビルドで使用されているパスを指定します）。

ビルドにかかわらず、コマンドの残りの形式は同じです。

最初の確認

1. CLI がインストールされているか、またどのデータモードを対象にしているか確認します。

helmor cli-status

2. アクティブなデータディレクトリとデータベースを確認します。

helmor data

出力をスクリプトや別のツールで解析する場合は、--json を使用してください。

CLI のインストールと更新

Helmor CLI のインストール／更新はベータ版として扱ってください。

• 管理対象 CLI エントリポイントのインストールや修復には、Helmor デスクトップのオンボーディング／設定にある Components パネルを優先してください。
• PATH 上のエントリが、現在のアプリ管理 CLI を参照しているか確認するには、helmor cli-status を使用してください。
• helmor --help またはサブコマンドのヘルプページに存在しない、安定版の単独インストール／更新コマンドを作り出さないでください。
• ユーザーが作業を進められない場合は、helmor cli-status を実行して出力を共有するよう依頼するか、Helmor リポジトリ内で作業している場合は、アプリの Components パネルを確認してください。

Helmor スキルのインストールと更新

Helmor スキルのインストール／更新は、ベータ版のアプリ管理フローとして扱ってください。

• バンドルされた Helmor スキルのインストールや更新には、Helmor デスクトップのオンボーディング／設定にある Components パネルを優先してください。
• トップレベルの CLI ヘルプには現在、helmor skills コマンドが公開されていないため、そのコマンドを作り出さないでください。
• リポジトリ内にあるバンドル済み Helmor スキルの更新をユーザーから依頼された場合は、スキルファイルを直接編集し、スキル検証ツールで検証してください。
• ユーザー向けのスキルコンテンツは簡潔にし、ユーザーが別の言語を明示的に求めない限り、英語を優先してください。

よくあるタスク

リポジトリとワークスペースの管理

ローカル中心のプロジェクト設定やワークスペースのオーケストレーションには、以下のコマンドグループを使用します。

helmor repo --help
helmor workspace --help

ワークスペースを作成する際は、明確なリポジトリ名と簡潔な目的ラベルを使用してください。

helmor workspace new --repo helmor

セッションとファイルの確認

会話履歴にはセッションを、エディター画面での操作にはファイルを使用します。

helmor session --help
helmor files --help

エージェントへのプロンプト送信

ユーザーがターミナルから作業を依頼したい場合は、send を使用します。

helmor send --help

自動化には JSON 出力を優先してください。

helmor --json send --help

インテグレーションとローカルツール

該当するコマンドグループを使用します。

helmor github --help
helmor scripts --help
helmor models --help

MCP サーバー

Helmor を stdio 経由の MCP サーバーとして実行します。

helmor mcp

別のエージェント／ランタイムから Model Context Protocol を介して Helmor を呼び出す必要がある場合に使用してください。

コマンドリファレンス

helmor --help のトップレベルのコマンド一覧が必要な場合は、references/helmor-help.md をお読みください。

コマンドグループの正確なフラグを確認するには、推測せずにそのグループのヘルプを実行してください。

helmor <command> --help