CLI

ターミナルから stdin/stdout を使用して PRX を直接操作し、外部サービスに依存することなく対話的な会話を行います。

前提条件

• PRX がインストール済みで、少なくとも 1 つの LLM プロバイダーが設定済み
• stdin/stdout をサポートするターミナル

クイックセットアップ

1. 設定

CLI チャネルはデフォルトで有効です。追加の設定は不要です。

[channels_config]
cli = true  # default, can be omitted

2. 起動

prx

PRX が対話モードで起動し、stdin から入力を読み取り、stdout にレスポンスを出力します。

3. 使い方

メッセージを入力して Enter を押します。特殊コマンド:

> Hello, how are you?
[PRX responds...]

> /quit    # セッションを終了
> /exit    # セッションを終了（別名）

設定リファレンス

フィールド	型	デフォルト	説明
cli	bool	true	CLI 対話チャネルの有効/無効を切り替え

機能

• ゼロ依存 -- LLM プロバイダー以外に外部アカウント、トークン、API は不要
• 常時利用可能 -- デフォルトで有効。インストール後すぐに動作
• stdin/stdout インターフェース -- 標準 Unix I/O でスクリプトやパイプに簡単に統合可能
• 空行フィルタリング -- 空行はサイレントに無視
• グレースフル終了 -- /quit または /exit でセッションをクリーンに終了
• 全ツールアクセス -- 設定済みのすべてのツール（シェル、ファイル、ブラウザ、メモリなど）が利用可能

制限事項

• シングルユーザー、シングルセッションのみ
• セッション間で会話履歴は保持されない（グローバルでセッション永続化が有効な場合を除く）
• メディアやファイル添付のサポートなし（テキストのみの入力）
• ストリーミング/プログレッシブ出力なし（レスポンスは生成完了後に一括出力）
• 明示的に設定しない限り、同一プロセス内で他のチャネルと同時実行不可

トラブルシューティング

PRX が CLI モードで起動しない

• [channels_config] で cli = true であることを確認（省略時はデフォルトで true）
• 他のチャネルが設定されている場合、PRX がそちらを優先する可能性あり。起動ログを確認
• 少なくとも 1 つの LLM プロバイダーが設定済みであることを確認

入力が処理されない

• PRX が実行中のターミナルで入力していることを確認（バックグラウンドプロセスではないこと）
• 空行は無視される。空でないメッセージを入力
• stdin が接続されていることを確認（/dev/null からリダイレクトされていないこと）

CLI でパイプを使用する方法

• PRX は stdin から 1 行ずつ読み取るため、入力をパイプできる:

  echo "What is 2 + 2?" | prx

• スクリプトでマルチターン会話を行う場合は、FIFO または expect ベースのアプローチを使用