Huly CLI
npx -y @starhui/huly-cli@latest を使用して @firfi/huly-mcp 経由で Huly と連携します。
このリポジトリ内でのローカル開発では、pnpm build && pnpm link --global 実行後、huly も使用可能です。
クイック確認
- CLI が利用可能かを確認:
npx -y @starhui/huly-cli@latest --version - 既存の環境変数からサニタイズされた設定を確認:
npx -y @starhui/huly-cli@latest context - 必要な設定が不足している場合、ユーザーに
--config <path>で明示的な dotenv ファイルを渡すかどうかを尋ねてください。 - 課題コマンドでプロジェクトを省略する場合は、
HULY_DEFAULT_PROJECTを設定するか、--projectを渡してください。
実際のトークン、パスワード、または .env の完全な内容を決して出力しないでください。npx -y @starhui/huly-cli@latest context はサニタイズされた設定を返すため安全です。
一般的なコマンド
プロジェクト一覧:
npx -y @starhui/huly-cli@latest project list --json
課題を作成または更新する前にステータスを確認:
npx -y @starhui/huly-cli@latest project statuses HULY --json
課題一覧:
npx -y @starhui/huly-cli@latest issue list --project HULY --status-category active --limit 20 --json
課題取得:
npx -y @starhui/huly-cli@latest issue get HULY-123 --project HULY --json
課題作成:
npx -y @starhui/huly-cli@latest issue create --project HULY --title "短い命令形のタイトル" --description "Markdown 本文"
課題更新:
npx -y @starhui/huly-cli@latest issue update HULY-123 --project HULY --status Done
検索:
npx -y @starhui/huly-cli@latest search "検索テキスト" --limit 10 --json
生のツールアクセス
ファーストクラスの CLI が上流の MCP ツールを公開していない場合は、生の呼び出しを使用します:
npx -y @starhui/huly-cli@latest tools --filter document
npx -y @starhui/huly-cli@latest call get_issue --field project=HULY --field identifier=HULY-123 --json
npx -y @starhui/huly-cli@latest call list_projects --data '{"limit":10}' --json
--field key=value は true、false、null、数値を自動変換します。ネストされた JSON には --data または --file を使用してください。
安全性
- エージェントによる解析には
--jsonを使用してください。 - 書き込み前に読み込み: ユーザーが正確な値を指定した場合を除き、プロジェクト/ステータス/課題を変更する前に検査してください。
- 破壊的なコマンドは確認を求めます。
--yesはユーザーが明示的に削除を要求した場合のみ渡してください。 project statusesのステータス名を使用してください。ワークフローステータスを独自に作成しないでください。- 認証/設定エラーでコマンドが失敗した場合は、
npx -y @starhui/huly-cli@latest contextの欠落しているサニタイズフィールドを報告してください。機密情報を公開しないでください。--config <path>での再試行は、ユーザーが使用する dotenv ファイルを確認した後にのみ行ってください。
便利なマッピング
- プロジェクト:
project list、project get、project statuses、project create、project update、project delete - 課題:
issue list、issue get、issue create、issue update、issue delete、issue label、issue unlabel、issue move - グローバル検索:
search - すべての上流 MCP ツール:
toolsとcall