TUI モード
任意のプロジェクトルートでqodercli を実行すると、既定の TUI（インタラクティブ）モードに入ります。CLI とはテキストで対話でき、スラッシュコマンドで専用機能を実行できます。
入力モード
TUI では複数の入力モードを利用できます。組み込みツール
Qoder CLI には、ファイル/ディレクトリ操作や shell コマンド実行に使える Grep、Read、Write、Bash などのツールが組み込まれています。 ツール機能と制御方法の詳細については、ツール を参照してください。スラッシュコマンド
以下の組み込みスラッシュコマンドで、機能や設定にすばやくアクセスできます。高度な起動オプション
CLI を起動する際は、以下のオプションで動作を制御できます。
権限関連の起動オプションと設定は 権限 を参照してください。
Print モード
Print モードは非対話型です。qodercli --print を実行するとこのモードに入り、出力は --output-format に従って表示されます。
フラグ
グローバルオプションは任意のコマンドで使用できます。Worktree
--worktree [name] を使うと、別の Git worktree で Qoder CLI セッションを開始できます。同じリポジトリに対して複数のセッションを並行して進め、メインのチェックアウトに触れたくない場合に便利です。
要件：Git リポジトリ内で実行し、ローカルに Git がインストールされていることを確認してください。
worktree で開始する
/ で区切ったセグメントを使用できます。/ を含む名前は、ディレクトリ名とブランチ名では + に変換されます。
新しい名前付き worktree を作成すると、Qoder CLI は <repo>/.qoder/worktrees/<flattened-name> に配置し、worktree-<flattened-name> という一時ブランチを使います。同じ名前の worktree がすでにある場合は、新しく作らずにそのディレクトリを再利用します。
新しい worktree は、利用できる場合はローカルの origin/HEAD が指す既定ブランチの ref から始まります。origin/HEAD が設定されていない場合、Qoder CLI は origin/main を解決または取得できればそれを使い、できなければ現在の HEAD にフォールバックします。最新のリモートコミットから始める必要がある場合は、先に git fetch origin を実行してください。
ローカルファイルをコピーする
新しい worktree はクリーンなチェックアウトなので、.env などの未追跡ファイルは既定では含まれません。新しい worktree にローカルファイルをコピーするには、リポジトリルートに .worktreeinclude を追加します。
.worktreeinclude に一致し、かつ Git で ignore されているファイルだけがコピーされます。プロジェクトローカル設定の .qoder/settings.local.json がある場合は自動でコピーされます。
再開とクリーンアップ
セッション終了時には、worktree のパスと再開用コマンドが表示されます。worktree-<flattened-name> ブランチが不要になった場合は、別途削除してください。
セッション中に worktree を使う
実行中のセッションでも、隔離された worktree で作業するよう Qoder CLI に依頼できます。Qoder CLI は現在のセッション用に worktree を作成して移動し、必要に応じて worktree を出て元の作業ディレクトリを復元できます。 Subagent でも worktree 隔離を使用できます。ファイル編集を別のチェックアウトで実行したい Markdown Subagent には、定義にisolation: worktree を追加します。クリーンな Subagent worktree は Subagent 終了後に削除され、変更がある worktree は保持されます。設定方法は サブエージェント を参照してください。
セッション中に作成する worktree と worktree 隔離を使う Subagent では、WorktreeCreate Hook でカスタム worktree パスを返すことができます。対応する WorktreeRemove のクリーンアップ動作については Hooks を参照してください。--worktree 起動オプション自体は Git リポジトリ内での使用を前提とし、Git で worktree を作成します。
ディレクトリやブランチを完全に手動で管理する場合は、Git で worktree を作成してから、そのディレクトリで Qoder CLI を起動します。
メモリ
Qoder CLI はAGENTS.md ファイルと任意の自動メモリで、セッションをまたいだ context を保持します。よく使うファイルは、ユーザーレベルの ~/.qoder/AGENTS.md、プロジェクトレベルの ${project}/AGENTS.md、ローカルプロジェクトレベルの ${project}/AGENTS.local.md です。
自動生成
対象プロジェクトで TUI を起動し、/init を入力すると、プロジェクトディレクトリに AGENTS.md が生成されます。
手動で管理
- プロジェクト内に
AGENTS.mdを作成し、内容を編集します。 - TUI で
/memoryを入力し、ユーザー、プロジェクト、ローカルのメモリファイルを管理します。 - 自動メモリが有効な場合は、
/memoryで auto-memory folder を開くか、/memory manageで自動保存されたメモリファイルを管理します。