TUI モード
qodercli
を実行すると、既定の TUI(インタラクティブ)モードに入ります。CLI とはテキストでやり取りでき、スラッシュコマンドで専用の機能を実行できます。
入力モード
Command | Description |
---|---|
> | ダイアログモード(デフォルト)。任意のテキストを入力して CLI と対話します。 |
! | Bash モード。ダイアログモードで ! を入力するとシェルコマンドを直接実行できます。 |
/ | スラッシュモード。ダイアログモードで / を入力して組み込みコマンドを開き、実行します。 |
# | メモリモード。ダイアログモードで # を入力して、AGENTS.md のメモリファイルに内容を追記します。 |
\ ⏎ | Enter で複数行入力を開始します。 |
組み込みツール
スラッシュコマンド
Command | Description |
---|---|
/login | Qoder アカウントにログインする |
/help | TUI のヘルプを表示する |
/init | プロジェクト内の AGENTS.md メモリファイルを初期化または更新する |
/memory | AGENTS.md メモリファイルを編集する |
/quest | 仕様駆動の委任タスクを実行する |
/review | ローカルの変更をコードレビューする |
/resume | セッションを一覧表示して再開する |
/clear | 現在のセッションの context 履歴をクリアする |
/compact | 現在のセッションの context 履歴を要約する |
/usage | 現在のクレジット使用状況を表示する |
/status | CLI のステータスを表示: バージョン、モデル、アカウント、API 接続状況、ツールのステータスなど |
/config | Qoder CLI のシステム設定を表示する |
/agents | サブエージェント用コマンド: 一覧、作成、管理 |
/bashes | 実行中のバックグラウンド Bash ジョブ(Bash ツールで開始)を一覧表示する |
/release-notes | Qoder CLI のリリースノートを表示する |
/vim | 入力を編集するため外部エディタを開く |
/feedback | Qoder CLI に関するフィードバックを送信する |
/quit | TUI を終了する |
/logout | Qoder アカウントからログアウトする |
高度な起動オプション
Command | Description | Example |
---|---|---|
-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 |
印刷モード
qodercli --print
を実行して起動します。出力は --output-format
に従って表示されます。
フラグ
Option | Description | Example |
---|---|---|
-p | Agent を非対話モードで実行する | qodercli -q -p hi |
--output-format | 出力形式:text、json、stream-json | qodercli --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 |
MCP サーバー
MCP サーバーの管理
-t
で MCP サーバーのタイプを指定します: stdio、sse、streamable-http。stdio サーバーは TUI とともに自動起動します。-s
でスコープを指定します: ユーザーレベルまたはプロジェクトレベル。必要に応じてプロジェクトごとに MCP サーバーを設定できます。- 追加した MCP サーバーは次のコマンドで管理します:
MCP サーバーのファイル
推奨ツール
- qodercli mcp add context7
-- npx -y @upstash/context7-mcp@latest
- qodercli mcp add deepwiki
-- npx -y mcp-deepwiki@latest
- qodercli mcp add chrome-devtools
-- npx chrome-devtools-mcp@latest
権限
設定
種類
- Read & Edit 読み取りルールは、Grep、Glob、LS などのすべてのファイル読み取りツールに適用されます。パターンは gitignore 形式のマッチングに従います。サポートされるパターン形式は次のとおりです:
Pattern | Description | Example | Matches |
---|---|---|---|
/path | システムルートからの絶対パス | Read(/Users/qoder_user/demo/**)) | /Users/qoder_user/demo/xx |
~/path | ホームディレクトリからのパス | Read(~/Documents/xx.png) | /Users/qoder_user/Documents/xx.png |
path or ./path | カレントディレクトリからの相対パス | Read(xx.java) | ./xx.java |
- WebFetch ネットワーク取得ツールのフェッチ先ドメインを制限します。
WebFetch(domain:example.com)
はフェッチ先を example.com に制限します
- Bash シェル実行ツールで許可するコマンドを制限します。
Bash(npm run build)
はコマンド npm run build と完全一致でマッチしますBash(npm run test:*)
は npm run test で始まるコマンドにマッチしますBash(curl http://site.com/:*)
は curl http://site.com/ で始まる curl コマンドにマッチします
Worktree
--worktree
で開始する並行実行ジョブです。1 つのリポジトリに対して複数の Git worktree を作成し、ジョブを並列で実行することで、プロセス間の読み取り/書き込み競合を回避できます。
要件: ローカルに Git がインストールされ、使用可能であることを確認してください。
Commands | Description |
---|---|
qodercli --worktree "job description | 新しい worktree ジョブを作成して開始 |
qodercli jobs --worktree | 既存の worktree ジョブを一覧表示 |
qodercli rm | ジョブを削除(worktree を削除) |
ジョブを作成する
qodercli --worktree "Your job description"
- コンテナ内で非対話モードで実行し、完了後にコンテナを停止するには
-p
を追加します。 - ジョブのコードブランチを指定するには
--branch
を追加します。 - そのほかの Agent オプション(例:
--max-turns
)は、コンテナ内の CLI にそのまま渡されます。ジョブ作成後はデフォルトで TUI モードに入ります。別々のターミナルで複数のジョブを起動できます。worktree によりジョブ同士が分離されます。
ジョブを表示
$ qodercli jobs --worktree
を使用して、現在のコードリポジトリで並行実行中のジョブを表示します。
- ID: 一意のジョブID(コンテナIDではありません)
- INIT PROMPT: 初期のジョブ記述(将来的にAI生成のタイトルになります)
- PATH: Git の worktree ディレクトリ
- STATUS: コンテナのステータスと同一
- CREATED: ジョブの作成時刻
ジョブの削除
注意: 削除は取り消せません。慎重に進めてください。
メモリ
AGENTS.md
を使用し、その内容は開発を支援する context として CLI に自動的に読み込まれます。代表的な内容:
- 開発基準や注意事項
- システム全体のアーキテクチャ
- …
自動生成
/init
を入力してプロジェクトディレクトリに AGENTS.md を生成します。
手動で管理
- プロジェクト内に
AGENTS.md
を作成し、内容を編集します。 - TUIで
#
を入力してメモリ編集モードに入り、プロジェクトのメモリファイルを Vim 風の操作で編集します。 - TUIで
/memory
を入力して、ユーザーまたはプロジェクトレベルのメモリファイルを選択して編集します。
サブエージェント
手動で作成
~/.qoder/agents/<agentName>.md
: ユーザーレベル。すべてのプロジェクトに適用${project}/agents/<agentName>.md
: プロジェクトレベル。現在のプロジェクトに適用
自動作成
/agents
を入力します。Tab を押して User または Project を選択し、Create new agent を選び、自動生成したいサブエージェントの要件を入力します。
サブエージェントを使う
/agent
でサブエージェントを一覧表示できます。タスクを実行するために、サブエージェントは明示的にも暗黙的にも呼び出せます。例えば:
コマンド
.md
ファイルでスラッシュ機能を拡張します。よく使うプロンプトをコマンドとして定義し、TUI でタスクを実行できます。
コマンドを作成する
~/.qoder/commands/.md
:ユーザーレベル。すべてのプロジェクトに適用${project}/commands/.md
:プロジェクトレベル。現在のプロジェクトに適用
例
~/.qoder/commands/quest.md
に保存します。
コマンドを使う
/quest
を入力してコマンドを実行します。プロンプトごとに 2 つのサブAgentを順に呼び出します。
フック
設定
~/.qoder/settings.json
:ユーザーレベル。すべてのプロジェクトに適用${project}/.qoder/settings.json
:プロジェクトレベル。現在のプロジェクトに適用${project}/.qoder/settings.local.json
:プロジェクトレベル。最優先(通常は .gitignore に追加)
.qoder/settings.json
にフックを追加します:
~/notification.sh
を作成し、CLI で設定を書き込めるように次の内容を追加します。
現在、Qoder CLI がサポートしているのは Notification フックのみです。各フックのステージは Agent のメイン実行フローに介入でき、CLI とは疎結合のまま動作します。より幅広い統合シナリオに対応するため、今後はツール呼び出しやセッション介入など、さらなるフックタイプの追加を予定しています。