メインコンテンツへスキップ

​
TUI モード

任意のプロジェクトルートで qodercli を実行すると、既定の TUI（インタラクティブ）モードに入ります。CLI とはテキストで対話でき、スラッシュコマンドで専用機能を実行できます。

​
入力モード

TUI では複数の入力モードを利用できます。
CommandDescription
>ダイアログモード（デフォルト）。任意のテキストを入力して CLI と対話します
!Bash モード。ダイアログモードで ! を入力すると shell コマンドを直接実行できます
/スラッシュモード。ダイアログモードで / を入力して組み込みコマンドを開き、実行します
\ ⏎Enter で複数行入力を開始します

​
組み込みツール

Qoder CLI には、ファイル/ディレクトリ操作や shell コマンド実行に使える Grep、Read、Write、Bash などのツールが組み込まれています。

​
スラッシュコマンド

以下の組み込みスラッシュコマンドで、機能や設定にすばやくアクセスできます。
CommandDescription
/loginQoder アカウントにログインする
/helpTUI ヘルプを表示する
/initプロジェクト内の AGENTS.md メモリファイルを初期化または更新する
/memoryユーザー、プロジェクト、ローカルのメモリファイルを管理する
/questSpec 駆動の委任タスクを実行する
/reviewローカル変更をコードレビューする
/resumeセッションを一覧表示して再開する
/clear現在のセッションの context 履歴をクリアする
/compact現在のセッションの context 履歴を要約する
/usage現在の Credit 使用状況を表示する
/statusCLI ステータスを表示する：バージョン、モデル、アカウント、API 接続状況、ツール状態など
/configQoder CLI のシステム設定を表示する
/agentsサブエージェントの一覧、作成、管理を行う
/tasks実行中のバックグラウンドタスクを一覧表示する
/release-notesQoder CLI のリリースノートを表示する
/vim入力を編集するため外部エディタを開く
/feedbackQoder CLI に関するフィードバックを送信する
/quitTUI を終了する
/logoutQoder アカウントからログアウトする

​
高度な起動オプション

CLI を起動する際は、以下のオプションで動作を制御できます。
CommandDescriptionExample
-wワークスペースディレクトリを指定するqodercli -w /Users/demo/projects/nacos
-c直近のセッションを続行するqodercli -c
-r指定したセッションを再開するqodercli -r *******-c09a-40a9-82a7-a565413fa39
--allowed-tools指定したツールのみ許可するqodercli --allowed-tools=Read,Write
--disallowed-tools指定したツールを禁止するqodercli --disallowed-tools=Read,Write
--max-turns最大ターン数qodercli --max-turns=10
--yolo権限チェックをスキップするqodercli --yolo
権限関連の起動オプションと設定は 権限 を参照してください。 Print モードは非対話型です。qodercli --print を実行するとこのモードに入り、出力は --output-format に従って表示されます。

​
フラグ

グローバルオプションは任意のコマンドで使用できます。
OptionDescriptionExample
-pAgent を非対話モードで実行するqodercli -q -p hi
--output-format出力形式：text、json、stream-jsonqodercli --output-format=json
-wワークスペースディレクトリを指定するqodercli -w /Users/qoder_user/projects/qoder_demo
-c直近のセッションを続行するqodercli -c
-r指定したセッションを再開するqodercli -r ********-c09a-40a9-82a7-a565413fa393
--allowed-tools指定したツールのみ許可するqodercli --allowed-tools=Read,Write
--disallowed-tools指定したツールを禁止するqodercli --disallowed-tools=Read,Write
--max-turns最大ターン数qodercli --max-turns=10
--yolo権限チェックをスキップするqodercli --yolo

​
Worktree

--worktree [name] を使うと、別の Git worktree で Qoder CLI セッションを開始できます。同じリポジトリに対して複数のセッションを並行して進めたい場合に便利です。
要件：Git リポジトリ内で実行し、ローカルに Git がインストールされていることを確認してください。

​
worktree で開始する

qodercli --worktree feature-a
qodercli --worktree feature-a "Implement the login fix"
qodercli --worktree
worktree 名を省略すると、Qoder CLI が自動で名前を生成します。worktree の準備が完了すると、Qoder CLI はその worktree に移動して通常どおりセッションを開始します。 セッション終了時には、worktree のパスと再開用コマンドが表示されます。 
cd <worktree-path> && qodercli --resume <session-id>
worktree を手動で削除するには、次を実行します。 
git worktree remove <worktree-path>

​
メモリ

Qoder CLI は AGENTS.md をメモリファイルとして使用し、その内容を開発支援の context として自動的に読み込みます。代表的な内容：
  • 開発基準や注意事項
  • システム全体のアーキテクチャ
  • …
ローカルファイルパス： 
# ユーザーレベル。すべてのプロジェクトに適用
~/.qoder/AGENTS.md
# プロジェクトレベル。現在のプロジェクトに適用
${project}/AGENTS.md
# ローカルプロジェクトレベル。このマシンでのみ使用
${project}/AGENTS.local.md

​
自動生成

対象プロジェクトで TUI を起動し、/init を入力すると、プロジェクトディレクトリに AGENTS.md が生成されます。

​
手動で管理

  • プロジェクト内に AGENTS.md を作成し、内容を編集します。
  • TUI で /memory を入力し、ユーザー、プロジェクト、ローカルのメモリファイルを管理します。