TUI モード
任意のプロジェクトルートディレクトリで qoder を実行すると、デフォルトの TUI（インタラクティブ）モードが起動します。テキストを通じて CLI と対話したり、スラッシュコマンドを使用して特定の機能を実行したりできます。
入力モード
TUI では複数の入力モードが提供されています。
| コマンド | 説明 |
|---|---|
> | ダイアログモード（デフォルト）。任意のテキストを入力して CLI と対話します |
! | Bash モード。ダイアログモードで ! を入力すると、シェルコマンドを直接実行できます |
/ | スラッシュモード。ダイアログモードで / を入力すると、組み込みコマンドを開いて実行できます |
\ ⏎ | Enter キーを押して複数行入力を開始します |
組み込みツール
Qoder CLI には Grep、Read、Write、Bash などのツールが組み込まれており、ファイルやディレクトリの操作、シェルコマンドの実行に使用できます。
ツールの機能と制御方法の詳細については、ツール を参照してください。
スラッシュコマンド
以下の組み込みスラッシュコマンドを使用して、機能や設定にすばやくアクセスできます。
| コマンド | 説明 |
|---|---|
/login | Qoder アカウントにサインインします |
/help | TUI のヘルプを表示します |
/init | プロジェクト内で AGENTS.md メモリファイルを初期化または更新します |
/memory | メモリ概要を開き、ユーザーレベル、プロジェクトレベル、ローカルメモリ、および自動メモリエントリを管理します |
/quest | インテリジェントワークフローオーケストレーター。専用サブエージェントを通じて機能開発をステップバイステップでガイドします |
/review | ローカルのコード変更をレビューします |
/resume | セッションを表示および復元します |
/clear | 現在のセッションの履歴コンテキストをクリアします |
/compact | 現在のセッションの履歴コンテキストを要約します |
/usage | 現在のクレジット使用状況を表示します |
/status | バージョン、モデル、アカウント、API 接続性、ツール状態などの CLI ステータスを表示します |
/config | Qoder CLI のシステム構成を表示します |
/effort | 現在のモデルの思考深度および関連するモデルパラメータを調整します |
/agents | サブエージェントコマンド：サブエージェントの表示、作成、管理 |
/tasks | 現在実行中のバックグラウンドタスクを表示します |
/release-notes | Qoder CLI の変更履歴を表示します |
/vim | Vim 編集モードを切り替えます |
/feedback | Qoder CLI に関するフィードバックを送信します |
/quit | TUI を終了します |
/logout | Qoder アカウントからサインアウトします |
高度な起動オプション
CLI の起動時に、以下のオプションを使用して動作を制御できます。
| コマンド | 説明 | 例 |
|---|---|---|
-w | 作業ディレクトリを指定します | qoder -w /Users/demo/projects/nacos |
-c | 前回のセッションを続行します | qoder -c |
-r | 指定したセッションを復元します | qoder -r *******-c09a-40a9-82a7-a565413fa39 |
--allowed-tools | 指定したツールのみを許可します | qoder --allowed-tools=Read,Write |
--disallowed-tools | 指定したツールを禁止します | qoder --disallowed-tools=Read,Write |
--tools | 使用可能な組み込みツールを制限します（"" ですべて無効化、default ですべて有効化） | qoder --tools=Read,Edit -p "Fix login" |
--max-turns | 最大会話ターン数 | qoder --max-turns=10 |
--worktree [name] | 独立した Git ワークツリーで起動します | qoder --worktree feature-a |
--yolo | 権限チェックをスキップします | qoder --yolo |
Print モード
Print モードは非対話モードです。qoder --print を実行すると起動し、出力は --output-format パラメータで指定された形式で印刷されます。
パラメータ
グローバルパラメータは任意のコマンドで使用できます。
| パラメータ | 説明 | 例 |
|---|---|---|
-p | 非対話モードでエージェントを実行します | qoder -p hi |
-o, --output-format | 出力形式：text、json、stream-json | qoder --output-format=json |
-w | 作業ディレクトリを指定します | qoder -w /Users/qoder_user/projects/qoder_demo |
-c | 前回のセッションを続行します | qoder -c |
-r | 指定したセッションを復元します | qoder -r ********-c09a-40a9-82a7-a565413fa393 |
--allowed-tools | 指定したツールのみを許可します | qoder --allowed-tools=Read,Write |
--disallowed-tools | 指定したツールを禁止します | qoder --disallowed-tools=Read,Write |
--max-turns | 最大会話ターン数 | qoder --max-turns=10 |
--worktree [name] | 独立した Git ワークツリーで起動します | qoder --worktree feature-a -p "Fix login" |
--yolo | 権限チェックをスキップします | qoder --yolo |
Worktree
--worktree [name] を使用すると、独立した Git ワークツリーで Qoder CLI セッションを起動できます。同じリポジトリ内で複数のタスクを並列処理する場合に最適であり、複数のセッションが同じ作業ディレクトリを共有したり、メインチェックアウトを変更したりするのを防ぎます。
要件：このコマンドは Git リポジトリ内で実行し、ローカルに Git がインストールされていることを確認してください。
ワークツリーでの起動
/ で区切られたセグメントを含めることができます。/ を含む名前は、ディレクトリ名とブランチ名において + に変換されます。
新しい名前付きワークツリーを作成する際、Qoder CLI はそれを <repo>/.qoder/worktrees/<flattened-name> 配下に配置し、worktree-<flattened-name> という名前の一時ブランチを作成します。同名のワークツリーが既に存在する場合、Qoder CLI は新しいものを作成せず、そのディレクトリを直接再利用します。
新しいワークツリーは、優先的にローカルの origin/HEAD が指すデフォルトブランチ参照に基づいて作成されます。origin/HEAD が構成されていない場合、Qoder CLI は origin/main を解決または取得できる場合にそれを使用し、そうでない場合は現在の HEAD にフォールバックします。最新のリモートコミットから開始する必要がある場合は、事前に git fetch origin を実行してください。
ローカルファイルのコピー
新しいワークツリーはクリーンなチェックアウトであり、デフォルトでは .env などの未トラッキングファイルは含まれません。ローカルファイルを新しいワークツリーにコピーする必要がある場合は、リポジトリのルートディレクトリに .worktreeinclude を追加します。
.worktreeinclude に一致し、かつ Git によって無視されているファイルのみがコピーされます。プロジェクトローカル設定の .qoder/settings.local.json が存在する場合は自動的にコピーされます。
復元とクリーンアップ
セッション終了時、Qoder CLI はワークツリーのパスと、そのセッションを復元するコマンドを出力します。
worktree-<flattened-name> ブランチが不要になった場合は、そのブランチのみを削除できます。
セッション内でのワークツリーの使用
既存のセッション内でも、Qoder CLI に分離されたワークツリーでタスクを処理するよう指示できます。現在のセッション用にワークツリーを作成して進入し、離れる必要がある場合は、ワークツリーを終了して元の作業ディレクトリを復元するよう指示できます。
サブエージェントでもワークツリー隔離を使用できます。特定の Markdown サブエージェントが独立したチェックアウトでファイルを変更する必要がある場合は、その定義に isolation: worktree を追加します。クリーンなサブエージェントワークツリーはサブエージェント終了後に削除されますが、変更のあるワークツリーは保持されます。構成方法の詳細については、サブエージェント を参照してください。
セッション内で作成されたワークツリーおよびワークツリー隔離が有効なサブエージェントに対しては、WorktreeCreate フックによってカスタムワークツリーパスを提供できます。関連する WorktreeRemove のクリーンアップ動作については、フック を参照してください。--worktree 起動引数自体は Git リポジトリ内での使用を前提としており、Git を使用してワークツリーを作成します。
ディレクトリとブランチを完全に手動で制御する必要がある場合は、Git を直接使用してワークツリーを作成し、そのディレクトリで Qoder CLI を起動できます。
メモリ
Qoder CLI は、AGENTS.md ファイルとオプションの自動メモリを使用して、セッション間でコンテキストを保持します。よく使用されるファイルには、ユーザーレベルの ~/.qoder/AGENTS.md、プロジェクトレベルの ${project}/AGENTS.md、およびローカルプロジェクトレベルの ${project}/AGENTS.local.md があります。
自動生成
対象プロジェクトで TUI を起動し、/init を入力すると、プロジェクトディレクトリ内に AGENTS.md が生成されます。
手動管理
- プロジェクト内に
AGENTS.mdを作成し、その内容を編集します。 - TUI で
/memoryを入力し、ユーザーレベル、プロジェクトレベル、およびローカルのメモリファイルを管理します。 - 自動メモリが有効な場合、
/memoryパネルで自動メモリフォルダーを開くか、/memory manageを入力して自動保存されたメモリファイルを管理できます。