Pi Agent: CLI Reference & Slash Commands
最終更新：2026-08-31
--- title: "CLIリファレンスとスラッシュコマンド" description: "Pi Agent CLIの完全リファレンス、すべてのコマンド、オプション、スラッシュコマンドを含みます。" order: 19 lang: ja
CLIはPi Agentの「コックピット」——コマンドを知れば、コントロールできる。
1. グローバルオプション
BASH
pi-agent [options] [command]
Options:
--version バージョン表示
--help ヘルプ表示
--config <path> 設定ファイルパスを指定
--verbose 詳細出力
--quiet 静寂モード
--debug デバッグモード
2. コアコマンド
(1) chat - インタラクティブチャット
BASH
pi-agent chat [options] [message]
Options:
--provider <name> LLMプロバイダーを指定
--model <name> モデルを指定
--skill <name> スキルを読み込み
--system <prompt> システムプロンプト
--session <name> セッションを復元
--context <file> コンテキストファイルを読み込み
--sandbox サンドボックスモードを有効化
(2) run - 非インタラクティブ実行
BASH
pi-agent run [options] <prompt>
Options:
--input <file> ファイルから入力を読み込み
--output <file> ファイルに出力
--format <type> 出力形式 (text|json|markdown)
--skill <name> スキルを使用
--stream ストリーミング出力
--timeout <seconds> タイムアウト
(3) config - 設定管理
BASH
pi-agent config set <key> <value>
pi-agent config get <key>
pi-agent config list
pi-agent config validate
3. ツールとスキルコマンド
(1) skills
BASH
pi-agent skills list
pi-agent skills show <name>
pi-agent skills create <name>
pi-agent skills install <package>
pi-agent skills remove <name>
(2) tools
BASH
pi-agent tools list
pi-agent tools show <name>
pi-agent tools test <name>
(3) ext
BASH
pi-agent ext list
pi-agent ext install <name>
pi-agent ext update <name>
pi-agent ext remove <name>
pi-agent ext create <name>
pi-agent ext publish <name>
4. セッションコマンド
BASH
pi-agent sessions list
pi-agent sessions show <name>
pi-agent sessions delete <name>
pi-agent sessions export <name>
pi-agent sessions search <query>
5. パッケージコマンド
BASH
pi-agent pkg search <query>
pi-agent pkg install <name>
pi-agent pkg update [name]
pi-agent pkg remove <name>
pi-agent pkg list
pi-agent pkg info <name>
pi-agent pkg build <name>
pi-agent pkg validate <name>
pi-agent pkg publish <name>
6. スラッシュコマンド（インタラクティブモード）
| コマンド | 説明 | 例 |
|---|---|---|
| /help | ヘルプ表示 | /help |
| /exit | 終了 | /exit |
| /clear | 会話をクリア | /clear |
| /model | モデル切替 | /model deepseek-reasoner |
| /provider | プロバイダー切替 | /provider openai |
| /tools | ツール一覧 | /tools |
| /use | ツール有効化 | /use shell |
| /unuse | ツール無効化 | /unuse search |
| /skill | スキル読み込み | /skill code_review |
| /save | セッション保存 | /save session.json |
| /load | セッション読み込み | /load session.json |
| /context | コンテキスト表示 | /context |
| /history | 履歴表示 | /history |
| /retry | 再生成 | /retry |
| /edit | 最後のメッセージ編集 | /edit |
| /theme | テーマ切替 | /theme dark |
| /trust | 信頼設定 | /trust readonly |
| /cost | コスト統計 | /cost |
| /branch | ブランチ作成 | /branch experiment |
7. よくある組み合わせ例
例1：コードレビューワークフロー（難易度：⭐）
BASH
pi-agent chat --skill code_review --system "You are a Python expert"
# インタラクティブモードで：
# /use file_reader
# /use search
# Review main.py code quality
# /save review_20260828.json
# /exit
例2：パイプバッチ処理（難易度：⭐⭐）
BASH
find . -name "*.py" -exec echo {} \; | pi-agent run --skill code_review "Review file list"
❓ よくある質問
Q コマンドが多すぎて覚えられない？
A インタラクティブモードで
/help と入力すればスラッシュコマンド一覧が表示されます。グローバルコマンドは pi-agent --help で。Q コマンドの省略形は？
A 一部のコマンドは省略形をサポート：
pi-agent c = pi-agent chat、pi-agent r = pi-agent run。Q スクリプト用のJSON出力は？
A
--format json を追加：pi-agent run "質問" --format json。📖 まとめ
- コアCLI：chat、run、config
- 管理：skills、tools、ext、sessions、pkg
- 20以上のスラッシュコマンドがインタラクティブモードで利用可能
- スクリプト統合用のJSON出力をサポート
📝 練習問題
- 基礎（難易度：⭐）: セッション作成→3ラウンドチャット→保存→再読み込みを完了してください。
- 中級（難易度：⭐⭐）: パイプと
pi-agent runを使ってPythonファイルをバッチレビューしてください。 - 上級（難易度：⭐⭐⭐）: よく使うPi Agent CLIの組み合わせをラップするシェルスクリプトを書き、ワンクリックでレビュー＋修正＋テストを実行してください。
