正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。
ドキュメントに関する現在のご利用体験についてお聞かせください。アンケートにご協力ください。

GitLab Duo CLIリファレンス

  • プラン: Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

GitLab Duo CLIを起動または実行するときは、これらのオプション、コマンド、および環境変数を使用します。

これは完全なリストではありません。完全な参照については、GitLab Duo CLI完全参照をご覧ください。

オプション

GitLab Duo CLIは、次のオプションをサポートしています:

  • -C, --cwd <path>: 作業ディレクトリを変更します。
  • -h, --help: GitLab Duo CLIまたは特定のコマンドのヘルプを表示します。例: duo --help、duo run --help。
  • -v、--version: バージョン情報を表示します。
  • --model <model>: セッションに使用するAIモデルを選択します。

オプションの完全なリストについては、GitLab Duo CLI完全参照をご覧ください。

コマンド

各セットアップでは次のコマンドを使用できます:

  • glab duo cli: インタラクティブモードを開始します。
  • glab duo cli log: ログを表示および管理します。
  • glab duo cli run: ヘッドレスモードを開始します。
  • duo: インタラクティブモードを開始します。
  • duo config: 設定と認証設定を管理します。
  • duo log: ログを表示および管理します。
  • duo run: ヘッドレスモードを開始します。

コマンドの完全なリストについては、GitLab Duo CLI完全参照をご覧ください。

環境変数

環境変数を使用してGitLab Duo CLIを設定できます:

  • DUO_WORKFLOW_GIT_HTTP_PASSWORD: Git HTTP認証パスワード。
  • DUO_WORKFLOW_GIT_HTTP_USER: Git HTTP認証ユーザー名。
  • GITLAB_BASE_URLまたはGITLAB_URL: GitLabインスタンスのURL。
  • GITLAB_DUO_MODEL: セッションに使用するAIモデル。
  • GITLAB_OAUTH_TOKENまたはGITLAB_TOKEN: 認証トークン。

GitLab Duo CLIがユーザーに代わってコマンドを実行すると、そのプロセスにAI_AGENT環境変数が設定されます。スクリプトやツールはAI_AGENTを読み取って、AIによって実行されていることを検出できます。

環境変数の完全なリストについては、GitLab Duo CLI完全参照をご覧ください。

ターミナルの進行状況シグナル

インタラクティブモードとヘッドレスモードの両方で、GitLab Duo CLIはOperating System Command（OSC）9;4の進行状況エスケープシーケンスを/dev/ttyに書き込むことでステータスを報告します。このシーケンスをサポートするターミナルは、GitLab Duo CLIを実行しているタブまたはウィンドウに進行状況インジケーターを表示します。ターミナルマルチプレクサとステータスツールは、同じシーケンスを解析してGitLab Duo CLIの状態を検出できます。

GitLab Duo CLIは、各シグナルをESC ] <sequence> ESC \として書き込みます。<sequence>は以下のいずれかです:

シーケンスステータス説明
9;4;3不確定GitLab Duo CLIはリクエストを処理しています。
9;4;4;50一時停止ツール呼び出しが承認を待っています。
9;4;0クリアGitLab Duo CLIはアイドル状態で、入力を待っています。
9;4;2Error最後のリクエストはエラーで終了しました。

GitLab Duo CLIは、その標準出力がターミナルにアタッチされており、/dev/ttyデバイスが利用可能な場合にのみ、これらのシグナルを書き込みます。シグナルは標準出力ではなく/dev/ttyに送られるため、リダイレクトされた出力やキャプチャされた出力には表示されません。GitLab Duo CLIが終了すると、進行状況ステータスがクリアされます。

GitLab Duo CLIがtmuxセッションで実行される場合、シーケンスはtmuxパススルーエスケープシーケンスでラップされます。tmux 3.3以降では、allow-passthroughオプションをオンにした場合にのみ、シーケンスは外部ターミナルに到達します。

GitLab Duo CLIは、セッションに注意が必要な場合にシステム通知を送信することもできます。