コンテンツにスキップ

Guide

Cookbook

Reference

Concepts

reyn agent

永続的な agent を管理します。それぞれ独自のプロファイル、履歴、Memory レイヤー、受信トレイを持つ長命な Session インスタンスです。

自動作成された default agent は常に存在します。reyn agent new で追加の名前付き agent を作成します。モデルについては コンセプト/multi-agent を参照してください。

概要

reyn agent <subcommand> [args]

サブコマンド: list、new、show、rm。

reyn agent list

すべてのアクティブな（アーカイブ済みでない）agent をアルファベット順に表示します。最終アクティビティのタイムスタンプと各プロファイルの role の最初の行も表示されます。アーカイブ済みの agent はこの一覧に表示されません。--all を渡すとアーカイブ済み agent も <name> (archived) の形式で表示され、確認・復元・パージできます。

reyn agent list          # アクティブな agent のみ
reyn agent list --all    # アーカイブ済み agent も表示

NAME        LAST ACTIVITY     ROLE
default     2026-05-01 13:00  
researcher  2026-05-01 12:55  deep technical research, prefers primary sources
writer      2026-04-30 18:20  concise long-form prose

reyn agent new <name> [--role TEXT] [--base-dir PATH] [--project-context-path PATH]

.reyn/agents/<name>/ 配下に新しい agent を作成します。ディレクトリは profile.yaml でプロビジョニングされます。history.jsonl、events.jsonl、memory/、runs/ は最初のアクティビティ時に作成されます。

reyn agent new researcher --role "deep technical research, prefers primary sources"
reyn agent new worker --base-dir repos/worker
reyn agent new coder1 --project-context-path coder1-context.md

<name> は agent 名の正規表現に一致する必要があります: [a-z0-9] で始まる [a-z0-9_-] の 1〜32 文字。

--role テキストは agent の LLM システムプロンプトに注入されます。短く具体的に書いてください。allowed_mcp・preferences・bounding には CLI からの宣言手段がまだ無いため、作成後に profile.yaml を直接編集してください。profile-yaml リファレンス を参照してください。

--base-dir（#5080）は、この agent 自身の作業ディレクトリ override を設定します — restrict-only、プロジェクトワークスペース内に解決される必要があり（相対パスはそれを基準に解決）、範囲外は clamp されず拒否されます。省略時は、agent はプロジェクト自身の base_dir にフォールバックします。session-spawn 自身の base_dir（spawn_session の LLM 向け引数）は、両方が設定された場合この agent レベルの既定より優先されます。

--project-context-path（#5111、--base-dir と同じ restrict-only 形状）は、この agent 自身の REYN.md/AGENTS.md override を設定し、この agent のセッションについてプロジェクト全体のファイルを置き換えます。省略時は、agent はプロジェクト全体のファイルにフォールスルーします。

reyn agent show <name>

プロファイルメタデータと解決されたフィールドを表示します:

reyn agent show researcher

name:        researcher
created_at:  2026-05-01T12:00:00+00:00
workspace:   /path/to/project/.reyn/agents/researcher
role:
  deep technical research, prefers primary sources

reyn agent rm <name> [--purge] [--yes]

デフォルトでは agent をアーカイブします（ソフトデリート — データは保持され、破棄されません）。--purge を指定すると agent ディレクトリとすべての rewind 履歴を永続的に破棄するハードデリートになります。

reyn agent rm researcher            # アーカイブ（確認プロンプトあり）
reyn agent rm researcher --yes      # アーカイブ、プロンプトをスキップ
reyn agent rm researcher --purge    # ハードデリート（確認プロンプトあり、不可逆）
reyn agent rm researcher --purge --yes

default agent は削除できません。

アーカイブ（デフォルト）

agent の .reyn/agents/<name>/ ディレクトリはそのまま保持されます — データは破棄されません。これが --purge との主な違いです:

  • PITR 世代が保持されます: WAL 由来のチェックポイント履歴が残るため、データは回復可能です。
  • Topology メンバーシップが保持されます: カスケードは発火しません。agent のチーム / ネットワーク所属は削除されません。
  • アーカイブ WAL seq を記録したトゥームストーンマーカーが書き込まれます（WAL ウィンドウ GC のヒンジ）。
  • agent はアクティブなサーフェスから非表示になります: reyn agent list、TUI Agents タブ、デフォルトトポロジールーティング、A2A can_send チェックのいずれもアーカイブ済み agent をスキップします。データが残っているだけで、破棄はされていません。

WAL ウィンドウ自動パージ: WAL 保持ウィンドウがアーカイブ seq を超えると、アーカイブ済み agent のディレクトリは自動的にハードデリートされます（ソフトデリートが rewind ウィンドウを外れたため、データはもはや回復不可能）。この時点で Topology カスケードが発火し、全 Topology から agent が削除されます。

パージ (--purge)

.reyn/agents/<name>/ をただちにハードデリートし、すべての PITR 世代を破棄します。パージ前へのタイムトラベルは意図的に非サポートです。Topology カスケードがただちに発火します（全 Topology から agent が削除され、リーダーがパージされた team Topology は完全に削除されます）。

復元ウィンドウが不要な場合、クリーンな完全削除として --purge を使用します。

Workspace レイアウト

各 agent は .reyn/agents/<name>/ を所有します:

パス 目的
profile.yaml 名前 / ロール / created_at / allowed_mcp
history.jsonl 追記専用の会話 + agent メッセージログ
events.jsonl ランタイムイベントの監査ログ
memory/MEMORY.md + body ファイル agent スコープの Memory レイヤー
runs/<run_id>/ Skill スポーンごとの Workspace

関連情報

On this page