スラッシュコマンドで Qoder CLI の動作をすばやく制御し、機能を呼び出してセッションを管理します。
スラッシュコマンド(コマンドとも呼ばれます)を使用して Qoder CLI の動作を制御し、特定のタスクを素早く呼び出します。
コマンドは、Qoder CLI で特定のタスクを呼び出すためのショートカットであり、スラッシュ記号(
ヘッドレスモードでは、プロンプトを送信するコマンドの実行がサポートされています。インタラクティブなセレクターやダイアログを開く必要があるコマンドは、TUI モードで使用してください。
Qoder CLI のコマンドは、以下の2種類に分類されます:
下表に一般的な組み込みコマンドを示します。完全なコマンド一覧、分類、およびエイリアスについては、スラッシュコマンドリファレンス を参照してください。
Qoder CLI では、プロンプトタイプのカスタムコマンドの作成がサポートされており、構成ファイルでコマンドの名前、説明、システムプロンプトを定義します。
会話内で必要なコマンドを直接説明し、Qoder に構成ファイル形式で生成させて対応するディレクトリに書き込ませます。例:
生成が完了したら、以下のディレクトリで構成ファイルを見つけて編集できます:
Markdown 形式のコマンド構成ファイルを直接作成し、コマンドのプロンプト内容を完全に制御します。
コマンド構成ファイルは Markdown 形式で、フロントマターメタデータとシステムプロンプトを含みます:
フィールドの説明:
命名規則:
以下は、Git コミットメッセージを生成するためのコマンド構成例です:
コマンド構成ファイルは、プロジェクトレベルまたはユーザーレベルのディレクトリに保存できます:
優先度: プロジェクトレベルとユーザーレベルに同名のコマンドが存在する場合、ユーザーレベル(
TUI の入力ボックスにコマンド名(
Enter キーを押してコマンドを送信すると、CLI はコマンド構成内のシステムプロンプトに従ってタスクの実行を開始します:
問題: 作成したカスタムコマンドが TUI に表示されない、または実行できない
解決策:
問題: コマンド構成の YAML 形式が正しくない
解決策:
/)のプレフィックスでトリガーされます。TUI モードで / を入力すると、利用可能なコマンド一覧を表示して選択・実行できます。
クイックスタート
TUI モードでのコマンドの使用
-
Qoder CLI を起動して TUI モードに入ります:
-
入力ボックスに
/文字を入力し、利用可能なコマンド一覧を表示します。 -
目的のコマンドを選択して Enter キーを押して実行します。たとえば、/config で Qoder CLI の構成項目を表示または変更します:
ヘッドレスモードでのコマンドの使用
ヘッドレスモードでは、プロンプトを送信するコマンドの実行がサポートされています。インタラクティブなセレクターやダイアログを開く必要があるコマンドは、TUI モードで使用してください。
コマンドの種類
Qoder CLI のコマンドは、以下の2種類に分類されます:
| 種類 | 説明 | 適用モード | 拡張性 |
|---|---|---|---|
| TUI タイプ | インタラクティブなインターフェース(ダイアログのポップアップ、リスト選択など)を提供します | TUI | システム組み込み、カスタマイズ不可 |
| プロンプトタイプ | 会話に事前定義されたプロンプトを送信し、CLI に特定のタスクを完了するよう指示します | TUI + ヘッドレス | ユーザーによるカスタム拡張をサポート |
組み込みコマンド
下表に一般的な組み込みコマンドを示します。完全なコマンド一覧、分類、およびエイリアスについては、スラッシュコマンドリファレンス を参照してください。
| コマンド | 種類 | 用途 |
|---|---|---|
/agents | TUI | サブエージェント一覧の表示と管理、サブエージェント構成の作成と編集をサポート |
/tasks | TUI | バックグラウンドタスクの表示と管理 |
/workflows | TUI | Dynamic workflows タスクパネルを開きます。Dynamic workflows を参照 |
/clear | TUI | 現在の会話内容をクリアして、新しい会話を開始します |
/commands | TUI | 利用可能なコマンド一覧を表示し、組み込み、Dynamic、スキル、プラグイン、ワークフローなどの分類で閲覧します |
/compact | プロンプト | 会話履歴を圧縮し、注目すべきポイントを指定できます |
/settings(エイリアス /config) | TUI | 構成管理、Qoder CLI の構成項目の表示または変更 |
/export [filename] | TUI | 現在のセッションをファイルにエクスポートします |
/feedback | TUI | フィードバックの送信または問題の報告 |
/help | TUI | ヘルプ情報を表示します |
/init | TUI | プロジェクトを初期化し、プロジェクト構造を分析して AGENTS.md メモリファイルを生成します |
/login | TUI | Qoder CLI アカウントにサインインします |
/logout | TUI | Qoder CLI アカウントからサインアウトします |
/mcp | TUI | MCP サーバー管理 |
/memory | TUI | メモリ概要を開きます。自動メモリが有効な場合は自動メモリフォルダーを開くか、/memory manage でトピックファイルを管理します |
/model | TUI | モデルレベル設定の表示と管理 |
/effort [level] | TUI | 現在のモデルの思考深度を設定します。level を渡さない場合はモデルパラメータパネルを開きます |
/context-window | TUI | 現在のモデルのコンテキストウィンドウを設定します。引数を渡さない場合はモデルパラメータパネルを開きます |
/fast [on|off] | TUI | 現在のモデルのクイックモードを切り替えます。引数を渡さない場合はモデルパラメータパネルを開きます |
/quest | プロンプト | インテリジェントワークフローオーケストレーター、複数のエージェントが連携してユーザーの機能開発を支援します |
/quit | TUI | Qoder CLI を終了します |
/release-notes | TUI | リリースノートを表示します |
/resume | TUI | 以前のセッションまたは会話履歴を復元し、Tab キーによるページ切り替えをサポートします |
/review | プロンプト | コードレビューを実行し、コードの品質と規範をチェックします |
/setup-github | TUI | GitHub 統合構成、GitHub 関連機能の設定 |
/skills | TUI | 現在のワークスペースのスキルコマンドを管理します |
/status | TUI | 現在のセッション状態とシステム情報を表示します |
/upgrade | TUI | プランをアップグレードします |
/usage | TUI | トークン消費量などの使用状況統計を表示します |
/vim | TUI | Vim モードを有効化または構成し、Vim スタイルの編集体験を提供します |
カスタムコマンドの作成
Qoder CLI では、プロンプトタイプのカスタムコマンドの作成がサポートされており、構成ファイルでコマンドの名前、説明、システムプロンプトを定義します。
方法1:Qoder に生成させる(推奨)
会話内で必要なコマンドを直接説明し、Qoder に構成ファイル形式で生成させて対応するディレクトリに書き込ませます。例:
/commands パネルは、分類(組み込み、Dynamic、スキル、プラグイン、ワークフローなど)ごとに現在利用可能なコマンド一覧を表示するためのものであり、作成エントリーポイントは提供しません。方法2:構成を手動で作成する
Markdown 形式のコマンド構成ファイルを直接作成し、コマンドのプロンプト内容を完全に制御します。
構成ファイル形式
コマンド構成ファイルは Markdown 形式で、フロントマターメタデータとシステムプロンプトを含みます:
| フィールド | 必須 | 説明 |
|---|---|---|
name | いいえ | TUI でのコマンドの表示名。呼び出し名はファイルパスによって決定され、このフィールドの影響を受けません |
description | はい | コマンドの機能説明、複数行のテキストをサポートします(YAML 構文を使用) |
- 小文字とハイフンを使用します(例:
git-commit) - スペースや特殊文字の使用は避けます
- ファイル名は
nameフィールドと一致させることを推奨します - サブディレクトリ内のコマンドは、名前空間の区切り文字として
:を使用します。たとえば、commands/git/commit.mdは/git:commitとして登録されます frontmatter.nameは TUI での表示名としてのみ機能し、コマンドの呼び出し名は常にファイルパスから導き出されます- 同じディレクトリ内に
SKILL.mdが存在する場合、そのディレクトリは単一のコマンド(/gitなど)として登録され、ディレクトリ内の他の兄弟.mdファイルは無視されます - コマンド名セグメントはそのまま保持され、文字の置換は行われません。ファイル名には入力しやすい文字を使用することをお勧めします
構成例
以下は、Git コミットメッセージを生成するためのコマンド構成例です:
保存場所と優先度
コマンド構成ファイルは、プロジェクトレベルまたはユーザーレベルのディレクトリに保存できます:
| レベル | パス | 適用範囲 | コードリポジトリへのコミット |
|---|---|---|---|
| プロジェクトレベル | .qoder/commands/<command_name>.md | 現在のプロジェクトのみ | コミット推奨(チーム共有) |
| ユーザーレベル | ~/.qoder/commands/<command_name>.md | すべてのプロジェクト | コミットしない(個人設定) |
~/.qoder/commands/)のコマンドが優先され、プロジェクトレベルの同名コマンドを上書きします。上書きされた定義は、コマンド詳細の Also defined at に一覧表示されます。
Qoder CLI が起動している状態で、コマンド構成ファイルを新規作成または変更した後、/commands を実行すると、再読み込みされて利用可能なコマンドが表示されます。
カスタムコマンドの表示と使用
コマンド一覧の表示
- TUI で
/commandsを実行してコマンド一覧パネルを開きます - Tab キーで分類タブ間を切り替えます(Built-in、Dynamic、Skill、Plugin、Workflow など。コマンドが存在する分類のみが表示され、タブには数が表示されます)
- 上下キーを使用して閲覧します。リストには各コマンドの名前と説明が表示されます。カスタムコマンドは Dynamic 分類に属します
- Esc キーを使用してパネルを終了します
.qoder/commands/ または ~/.qoder/commands/ 下の .md ファイル)を直接開いてください。
コマンドの実行
TUI の入力ボックスにコマンド名(/ で始まる)を入力すると、CLI は一致するコマンドリストを自動的に表示します:
よくある質問
カスタムコマンドが認識されない
問題: 作成したカスタムコマンドが TUI に表示されない、または実行できない
解決策:
- 構成ファイルのパスが正しいか確認します(
~/.qoder/commands/または.qoder/commands/) - フロントマターの形式が正しいか確認します(
---で始まり、終わること) /commandsを実行してコマンドリストを再読み込みします。それでも認識されない場合は、CLI を再起動します(/quitで終了した後、qoderを再実行します)
フロントマターの解析に失敗する
問題: コマンド構成の YAML 形式が正しくない
解決策:
- フロントマターが
---で始まり、終わっていることを確認します |構文を使用して複数行のdescriptionフィールドを定義します- インデントが正しいか確認します(YAML はインデントに敏感です)