Skip to main content
Qoder CLI の拡張

コマンド

スラッシュコマンドで Qoder CLI の動作をすばやく制御し、機能を呼び出してセッションを管理します。

スラッシュコマンド(コマンドとも呼ばれます)を使用して Qoder CLI の動作を制御し、特定のタスクを素早く呼び出します。 コマンドは、Qoder CLI で特定のタスクを呼び出すためのショートカットであり、スラッシュ記号(/)のプレフィックスでトリガーされます。TUI モードで / を入力すると、利用可能なコマンド一覧を表示して選択・実行できます。

クイックスタート

TUI モードでのコマンドの使用

  1. Qoder CLI を起動して TUI モードに入ります:
    qoder
    
  2. 入力ボックスに / 文字を入力し、利用可能なコマンド一覧を表示します。
  3. 目的のコマンドを選択して Enter キーを押して実行します。たとえば、/config で Qoder CLI の構成項目を表示または変更します:
    /config
    

ヘッドレスモードでのコマンドの使用

ヘッドレスモードでは、プロンプトを送信するコマンドの実行がサポートされています。インタラクティブなセレクターやダイアログを開く必要があるコマンドは、TUI モードで使用してください。
# コマンドを実行(追加の指示を含む)
qoder -p '/review コメントのカバレッジを重点的にチェック'

# カスタムプロンプトコマンドを実行
qoder -p '/git-commit'

コマンドの種類

Qoder CLI のコマンドは、以下の2種類に分類されます:
種類説明適用モード拡張性
TUI タイプインタラクティブなインターフェース(ダイアログのポップアップ、リスト選択など)を提供しますTUIシステム組み込み、カスタマイズ不可
プロンプトタイプ会話に事前定義されたプロンプトを送信し、CLI に特定のタスクを完了するよう指示しますTUI + ヘッドレスユーザーによるカスタム拡張をサポート

組み込みコマンド

下表に一般的な組み込みコマンドを示します。完全なコマンド一覧、分類、およびエイリアスについては、スラッシュコマンドリファレンス を参照してください
コマンド種類用途
/agentsTUIサブエージェント一覧の表示と管理、サブエージェント構成の作成と編集をサポート
/tasksTUIバックグラウンドタスクの表示と管理
/workflowsTUIDynamic workflows タスクパネルを開きます。Dynamic workflows を参照
/clearTUI現在の会話内容をクリアして、新しい会話を開始します
/commandsTUI利用可能なコマンド一覧を表示し、組み込み、Dynamic、スキル、プラグイン、ワークフローなどの分類で閲覧します
/compactプロンプト会話履歴を圧縮し、注目すべきポイントを指定できます
/settings(エイリアス /configTUI構成管理、Qoder CLI の構成項目の表示または変更
/export [filename]TUI現在のセッションをファイルにエクスポートします
/feedbackTUIフィードバックの送信または問題の報告
/helpTUIヘルプ情報を表示します
/initTUIプロジェクトを初期化し、プロジェクト構造を分析して AGENTS.md メモリファイルを生成します
/loginTUIQoder CLI アカウントにサインインします
/logoutTUIQoder CLI アカウントからサインアウトします
/mcpTUIMCP サーバー管理
/memoryTUIメモリ概要を開きます。自動メモリが有効な場合は自動メモリフォルダーを開くか、/memory manage でトピックファイルを管理します
/modelTUIモデルレベル設定の表示と管理
/effort [level]TUI現在のモデルの思考深度を設定します。level を渡さない場合はモデルパラメータパネルを開きます
/context-windowTUI現在のモデルのコンテキストウィンドウを設定します。引数を渡さない場合はモデルパラメータパネルを開きます
/fast [on|off]TUI現在のモデルのクイックモードを切り替えます。引数を渡さない場合はモデルパラメータパネルを開きます
/questプロンプトインテリジェントワークフローオーケストレーター、複数のエージェントが連携してユーザーの機能開発を支援します
/quitTUIQoder CLI を終了します
/release-notesTUIリリースノートを表示します
/resumeTUI以前のセッションまたは会話履歴を復元し、Tab キーによるページ切り替えをサポートします
/reviewプロンプトコードレビューを実行し、コードの品質と規範をチェックします
/setup-githubTUIGitHub 統合構成、GitHub 関連機能の設定
/skillsTUI現在のワークスペースのスキルコマンドを管理します
/statusTUI現在のセッション状態とシステム情報を表示します
/upgradeTUIプランをアップグレードします
/usageTUIトークン消費量などの使用状況統計を表示します
/vimTUIVim モードを有効化または構成し、Vim スタイルの編集体験を提供します

カスタムコマンドの作成

Qoder CLI では、プロンプトタイプのカスタムコマンドの作成がサポートされており、構成ファイルでコマンドの名前、説明、システムプロンプトを定義します。

方法1:Qoder に生成させる(推奨)

会話内で必要なコマンドを直接説明し、Qoder に構成ファイル形式で生成させて対応するディレクトリに書き込ませます。例:
> Help me create a custom command: view all git changes and generate a conventional commit message, and save it as a project-level command
生成が完了したら、以下のディレクトリで構成ファイルを見つけて編集できます:
# プロジェクトレベル
.qoder/commands/

# ユーザーレベル
~/.qoder/commands/
/commands パネルは、分類(組み込み、Dynamic、スキル、プラグイン、ワークフローなど)ごとに現在利用可能なコマンド一覧を表示するためのものであり、作成エントリーポイントは提供しません。

方法2:構成を手動で作成する

Markdown 形式のコマンド構成ファイルを直接作成し、コマンドのプロンプト内容を完全に制御します。

構成ファイル形式

コマンド構成ファイルは Markdown 形式で、フロントマターメタデータとシステムプロンプトを含みます:
---
name: command-name
description: コマンドの機能の説明。TUIのコマンド一覧に表示されます
---

ここにはコマンドのシステムプロンプトの内容を記述します。
ユーザーがこのコマンドを実行すると、このプロンプトが会話に送信され、CLIが特定のタスクを実行するように指示します。

複数行のテキストを使用でき、Markdown形式に対応しています。
フィールドの説明
フィールド必須説明
nameいいえTUI でのコマンドの表示名。呼び出し名はファイルパスによって決定され、このフィールドの影響を受けません
descriptionはいコマンドの機能説明、複数行のテキストをサポートします(YAML 構文を使用)
命名規則
  • 小文字とハイフンを使用します(例:git-commit
  • スペースや特殊文字の使用は避けます
  • ファイル名は name フィールドと一致させることを推奨します
  • サブディレクトリ内のコマンドは、名前空間の区切り文字として : を使用します。たとえば、commands/git/commit.md/git:commit として登録されます
  • frontmatter.name は TUI での表示名としてのみ機能し、コマンドの呼び出し名は常にファイルパスから導き出されます
  • 同じディレクトリ内に SKILL.md が存在する場合、そのディレクトリは単一のコマンド(/git など)として登録され、ディレクトリ内の他の兄弟 .md ファイルは無視されます
  • コマンド名セグメントはそのまま保持され、文字の置換は行われません。ファイル名には入力しやすい文字を使用することをお勧めします

構成例

以下は、Git コミットメッセージを生成するためのコマンド構成例です:
---
name: git-commit
description: Use this command when you need to review all git changes in the current repository and generate a well-structured commit message. This is particularly useful before committing code changes, especially after completing a feature or fixing a bug.
---

You are an expert Git commit message generator. Your role is to analyze all git changes in the repository and create clear, concise, and meaningful commit messages that follow conventional commit standards.

When analyzing changes, you will:
1. Examine all staged and unstaged changes using `git diff` and related commands
2. Identify the type of changes (feat, fix, chore, docs, style, refactor, test, etc.)
3. Determine the scope of changes (which component/module was affected)
4. Summarize the primary change in a clear subject line (50 characters or less)
5. Provide a detailed body explanation if the changes are complex
6. Follow conventional commit format: `<type>(<scope>): <subject>`

Your commit message structure should be:
- Subject line: Brief summary starting with change type
- Blank line
- Body (if needed): Detailed explanation of what changed and why
- Wrap lines at 72 characters

Best practices you follow:
- Use imperative mood ("add" not "added")
- Be specific about what was changed
- Reference issue numbers when relevant
- Keep subject line under 50 characters
- Explain the 'why' behind significant changes
- Group related changes logically

If you encounter unclear changes or need more context, ask clarifying questions. If there are no changes, inform the user accordingly. Always verify your analysis covers all modifications before generating the final commit message.

保存場所と優先度

コマンド構成ファイルは、プロジェクトレベルまたはユーザーレベルのディレクトリに保存できます:
レベルパス適用範囲コードリポジトリへのコミット
プロジェクトレベル.qoder/commands/<command_name>.md現在のプロジェクトのみコミット推奨(チーム共有)
ユーザーレベル~/.qoder/commands/<command_name>.mdすべてのプロジェクトコミットしない(個人設定)
優先度: プロジェクトレベルとユーザーレベルに同名のコマンドが存在する場合、ユーザーレベル~/.qoder/commands/)のコマンドが優先され、プロジェクトレベルの同名コマンドを上書きします。上書きされた定義は、コマンド詳細の Also defined at に一覧表示されます。 Qoder CLI が起動している状態で、コマンド構成ファイルを新規作成または変更した後、/commands を実行すると、再読み込みされて利用可能なコマンドが表示されます。

カスタムコマンドの表示と使用

コマンド一覧の表示

  1. TUI で /commands を実行してコマンド一覧パネルを開きます
  2. Tab キーで分類タブ間を切り替えます(Built-in、Dynamic、Skill、Plugin、Workflow など。コマンドが存在する分類のみが表示され、タブには数が表示されます)
  3. 上下キーを使用して閲覧します。リストには各コマンドの名前と説明が表示されます。カスタムコマンドは Dynamic 分類に属します
  4. Esc キーを使用してパネルを終了します
パネルは閲覧専用です。特定のカスタムコマンドの完全なシステムプロンプトを確認したい場合は、対応する構成ファイル(.qoder/commands/ または ~/.qoder/commands/ 下の .md ファイル)を直接開いてください。

コマンドの実行

TUI の入力ボックスにコマンド名(/ で始まる)を入力すると、CLI は一致するコマンドリストを自動的に表示します:
╭───────────────────────────────────────────────────────╮
│ > /git-commit                                                                         │
╰───────────────────────────────────────────────────────╯
  /git-commit        [user] Use this command when you need to review all git changes ...
Enter キーを押してコマンドを送信すると、CLI はコマンド構成内のシステムプロンプトに従ってタスクの実行を開始します:
> /git-commit

● I'll help you create a commit message by analyzing the git changes in your repository.
  Let me first check the current status.

● Bash (git status)
...

よくある質問

カスタムコマンドが認識されない

問題: 作成したカスタムコマンドが TUI に表示されない、または実行できない 解決策:
  1. 構成ファイルのパスが正しいか確認します(~/.qoder/commands/ または .qoder/commands/
  2. フロントマターの形式が正しいか確認します(--- で始まり、終わること)
  3. /commands を実行してコマンドリストを再読み込みします。それでも認識されない場合は、CLI を再起動します(/quit で終了した後、qoder を再実行します)

フロントマターの解析に失敗する

問題: コマンド構成の YAML 形式が正しくない 解決策:
  • フロントマターが --- で始まり、終わっていることを確認します
  • | 構文を使用して複数行の description フィールドを定義します
  • インデントが正しいか確認します(YAML はインデントに敏感です)
---
name: my-command
description: |
  これは1行目の説明です
  これは2行目の説明です
---
Qoder CLI を使用する