proxyman-cli

Proxyman CLI

ユーザーの Proxyman ビルドにインストールされている CLI を使用してください。静的なドキュメントを根拠に、コマンド階層やフラグを決めつけないでください。

バージョンに合った構文を確認する

Proxyman MCP が接続されている場合：

1. トップレベルのヘルプを表示するには、空のコマンドパスを指定して get_proxyman_cli_help を呼び出します。
2. export-log や rules map-local create など、コマンド名だけを指定して、もう一度呼び出します。
3. command_path にフラグ、値、パイプ、リダイレクト、シェル構文を含めないでください。
4. 返された構文を使用し、エージェントホストのシェルから、許可された操作コマンドを実行します。MCP ヘルパーはコマンドを実行しません。確認済みの activate コマンドのように、サポートされているシークレット入力が引数しかない場合は、ユーザーが実行するためのコマンド例を提示してください。

MCP が利用できない場合：

1. シェルプロファイルを変更せずに、実際の実行ファイルを特定します。
2. その実行ファイルに --help を指定して実行します。
3. 必要な引数とオプションがすべて判明するまで、ネストされた --help を実行します。
4. CLI が見つからない場合は、アプリのインストール／更新または GUI を案内してください。推測した構文で代用しないでください。

公式のコマンドラインページは参考情報として役立ちますが、正確な構文についてはインストール済みのヘルプを優先してください。コマンドカタログを参照して階層を選び、その後、実際の環境で確認してください。

実行前に計画する

1. ユーザーの意図に合うコマンド階層を 1 つ選びます。
2. 可能であれば、MCP、CLI の list/get、または GUI を使って現在の状態を確認します。
3. コマンドを分類します。
   • 読み取り専用：help、list、get、status。
   • ファイルシステムへの書き込み：export、export-log。保存先を明示し、既存ファイルを上書きする前に確認します。
   • 元に戻せる変更：on/off、enable/disable、create/update。
   • 破壊的／機微な操作：unlink、delete/remove、clear、上書きインポート、ルート証明書／カスタム証明書の変更、認証情報を扱う操作。
4. シークレットをプレースホルダーに置き換えたコマンドの形式を提示します。
5. 破壊的な操作や、新たに要求されたシステム／信頼／プロキシの変更について確認を得ます。
6. 1 回だけ実行し、終了ステータス、stdout、stderr を取得して、シークレットをマスキングします。
7. 別の status/list/get 操作で状態を確認します。

安全に関するルール

• フラグをでっち上げたり、インストール済みのヘルプを確認せずにコマンド例を根拠としたりしないでください。
• ライセンスキー、証明書のパスワード、プロキシ認証情報、Cookie、トークン、キャプチャしたシークレットを出力に含めないでください。
• ライセンスの入力には GUI を優先してください。確認済みの activate コマンドはキーを引数としてのみ受け付けるため、シェル履歴、プロセス一覧、エージェントのツール呼び出しに露出する可能性があります。
• 実際のキーを使った位置引数形式の activate をエージェントホストから実行しないでください。ユーザー自身のターミナルで置き換えて実行できるよう、バージョンに合った <LICENSE_KEY> を含むコマンド形式を提示してください。
• 証明書のパスワードを、コミット済みスクリプトや再利用可能なシェル履歴に埋め込まないでください。現在のヘルプでサポートされている、最も安全な入力方法を使用してください。
• activate、unlink、clear-session、ルールの delete/remove、上書き指定付きの構成インポート、カスタム／ルート証明書の変更、プロキシのルーティング変更は、実際の影響に応じて扱ってください。
• MCP がヘルプを返したというだけで、生成されたシェルコマンドを実行しないでください。実行の可否は、ユーザーの依頼と確認に従います。
• ファイルパスを明示してください。エクスポート前に出力先を、インポート／証明書操作の前に入力元を確認してください。
• ユーザーから明示的に依頼されない限り、実行ファイルを見つけやすくするためにシェルプロファイルを変更しないでください。

主なコマンド群

インストール済みのビルドでは、次のコマンドが利用できる場合があります。

• ライセンス：activate、unlink；
• アプリケーションの状態：proxy、proxy-host、mcp、clear-session；
• 設定：export、import；
• ログ：export-log；
• 証明書：custom-cert、install-root-cert；
• デバッグツール：Breakpoint、Map Local、Map Remote、Scripting、Block List、Allow List、Reverse Proxy、Network Condition、No Caching、DNS Spoofing、External Proxy；
• rules の下に統合されたルール操作。

これはコマンドの振り分けであり、構文を示すものではありません。ルールのワークフローについては、ルールの自動化を参照してください。

重要なワークフロー

MCP サーバーの状態

アプリを終了している間も含め、Proxyman の MCP サーバーを永続的に有効化または無効化したい場合は、バージョンに対応した mcp on／mcp off の階層を使用してください。有効化した後は MCP クライアントを再読み込みし、ツールが動作することを期待する前に Proxyman を起動してください。

ライセンスの有効化

activate --help を確認してください。ただし、ユーザーにキーを尋ねたり、エージェントホスト経由で確認済みの位置引数形式を実行したりしないでください。ユーザーが直接実行できるよう、<LICENSE_KEY> を含むコマンド形式を提示してください。有効化に成功した後、ライセンス状態を確認する前に Proxyman を再起動するようユーザーに伝えてください。明示的な許可なくアプリを終了しないでください。

ログまたは設定のエクスポート

1. 出力形式、フィルター、フロー境界のオプション、パスの規則を確認します。
2. 保存先を明確に指定し、ユーザーから依頼がない限り上書きを避けます。
3. キャプチャされたログに、マスキングされていない秘密情報が含まれる可能性があることを警告します。
4. 作成されたファイルの存在を確認し、秘密情報の内容ではなく、パスとサイズを報告します。

設定のインポート

1. ソースパスを検証し、マージ／上書きの動作を確認します。
2. 既存の設定が保持されるのか置き換えられるのかを説明します。
3. 上書き／置き換えには確認を求めます。
4. 作成されたルール一覧を確認します。

証明書

Proxyman のデフォルト CA と、カスタムルート証明書またはサーバー／クライアント証明書のインポートを区別してください。該当するサブコマンド、証明書の種類、パスワードの扱い、信頼オプションを確認します。信頼ストアを変更する前に確認を得てください。

結果の形式

次の形式で報告してください。

Executable/version:
Command hierarchy:
Action:
Exit status:
Sanitized output:
Verification:
Rollback or next step:

実行が許可されていない場合、または実行できない場合は、プレースホルダーを含む検証済みのコマンド形式を提示し、ユーザー側で何を行う必要があるかを正確に伝えてください。