`reyn chat`¶

agent にアタッチされたインタラクティブな REPL セッションを開始します。各ユーザーターンは skill_router stdlib Skill を通じてディスパッチされ、意図を分類して直接返信、プロジェクト/stdlib Skill の実行、または別の agent への委任を行います。

Memory の検索と書き込みはルーター Phase の内部で自動的に行われます。コンセプト/memory を参照してください。

概要¶

reyn chat [agent_name] [OPTIONS]

agent_name は位置引数でオプションです。省略すると、Reyn は自動作成された default agent にアタッチします。

オプション¶

共通ランタイムフラグ（--model、--output-language、--phase-budget、--llm-timeout、--llm-max-retries）は reyn run / reyn eval と共有です。共通フラグを参照してください。

chat 固有のフラグ:

フラグ	デフォルト	説明
`--cui`	オフ	プレーンコンソール出力（TUI なし）を使用。パイプ、デバッグ、ヘッドレス環境に便利。
`--no-restore`	オフ	起動時にディスクからの進行中 Skill ステートの復元をスキップ。デバッグやクリーンなセッション開始に便利。
`--reset`	オフ	起動前に進行中 Skill ステート（スナップショット + WAL）を消去。`.reyn/events/` の監査ログは保持されます。
`--banner`	オフ	ASCII アートの起動バナー（グラデーション REYN ロゴ + agent/モデル情報）を表示。
`--eager-embedding-build`	オフ	初回ターンでアクション埋め込みインデックスのビルドを同期的に待機（1 回のみ約 2〜5 秒）。`search_actions` を即時利用可能にする。
`--allow-unsafe-python`	オフ	`mode: unsafe` の Python preprocessor ステップを有効化。`--allow-untrusted-python` はレガシーエイリアス。

agent Workspace¶

各 agent は .reyn/agents/<name>/ 配下に状態を永続化します:

profile.yaml — 名前、ロール、オプションの allowed_mcp(リファレンス)
history.jsonl — 追記専用の会話ログ（chat + agent 間メッセージ、クロス agent トレース用の chain_id 付き）
events.jsonl — reyn events 用のランタイムイベント
memory/ — agent スコープの Memory レイヤー（MEMORY.md + body ファイル）
runs/ — 起動された Skill のランの Workspace

前の会話を再開するには、同じ agent にアタッチします:

reyn chat researcher

default agent は常に存在します。reyn agent new でさらに作成します。

スラッシュコマンド¶

セッションがアクティブな間、/ で始まる行は処理され、agent にルーティングされません。

コマンド	効果
`/list`	実行中の Skill スポーンと保留中の介入を表示
`/cancel <id>`	Skill スポーンをキャンセル（完全な id または最後の 4 文字）
`/answer <id> <text>`	保留中の `ask_user` / Permission プロンプトに回答
`/agents`	読み込まれた agent と現在アタッチされているものを一覧表示
`/attach <name>`	REPL ポインターを別の agent に切り替える（前の agent はバックグラウンドで実行し続ける）
`/session new \\| switch <sid> \\| list`	アタッチ中 agent の会話セッションを開く / 切り替える / 一覧表示（Sessions 参照）
`/skill list`	実行中の Skill 実行を表示（id / 名前 / current_phase + 親子関係）
`/skill discard <run_id>`	特定の Skill 実行を中止して cleanup を実行
`/tasks`	動作中の Skill 実行の統合ビュー。`/tasks list` と同じ
`/tasks status <prefix>`	特定の Skill 実行の current phase + 経過時間を表示
`/tasks kill <prefix>`	特定の Skill 実行を中止。prefix は Skill の run_id とマッチ

/list / /cancel / /answer は基盤となります。複数の Skill 実行と介入がプロンプトをブロックせずに共存できます。/agents / /attach はマルチエージェントワークフローのプリミティブです。/skill は crash recovery オペレーターコマンドで、per-skill-run のライフサイクルを surface します。/tasks は Skill 実行の統合エントリーポイントで、Skill が spawn された後に LLM が user に /tasks で進捗確認を案内します。

マルチエージェントの動作¶

ルーターがこのターンは別の agent が処理した方がよいと判断した場合、skills_to_run エントリーの代わりに（またはそれに加えて）messages_to_agents エントリーを出力します。受信 agent はリクエストを非同期に処理します。返信は発信元のチェーンに自動ルーティングされて戻ります。完全なモデルについてはコンセプト/multi-agent を参照してください。

ユーザーが開始したチェーンは中間の reply_text（発信元 agent の最初のルーターターン）を発行し、その後デリゲートのレスポンスが届いた後に最終的な統合された返信が続きます。これにより、ホップをまたいでも「作業中です」という UX が保たれます。

/attach スラッシュコマンドでチェーン途中のデリゲートの進捗を監視できます。前の agent の session.run() は受信トレイを消費し続けるので、後で戻っても問題なく解決されます。

Permission の動作¶

reyn chat はインタラクティブです。サブ Skill がデフォルト外の Permission を必要とする場合、介入キュー経由で応答するまでプロンプトがブロックします。選択は .reyn/approvals.yaml に永続化できます（permissions リファレンスを参照）。

例¶

デフォルト agent に対して新しいセッションを開始:

reyn chat

名前付き agent にアタッチ:

reyn chat researcher

この会話のみにより強力なモデルを使用:

reyn chat --model strong

reyn chat¶

概要¶