コンテンツにスキップ

reyn agent

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

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

概要

reyn agent <subcommand> [args]

サブコマンド: listnewshowrm

reyn agent list

すべての既知の agent をアルファベット順に表示します。最終アクティビティのタイムスタンプと各プロファイルの role の最初の行も表示されます。

reyn agent list
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]

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

reyn agent new researcher --role "deep technical research, prefers primary sources"

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

--role テキストは agent の LLM システムプロンプトに注入されます。短く具体的に書いてください。作成後に allowed_skills や他のプロファイルフィールドを設定するには、profile.yaml を直接編集してください。profile-yaml リファレンス を参照してください。

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
allowed_skills: (unrestricted — all project + stdlib skills)
role:
  deep technical research, prefers primary sources

allowed_skills は以下のいずれかで表示されます:

  • (unrestricted — all project + stdlib skills) — フィールドなし / null
  • (none — router-only, no skill spawn) — 空リスト []
  • 箇条書きリスト — 設定された allowlist

reyn agent rm <name> [--yes]

agent のディレクトリを再帰的に削除します(履歴、イベント、Memory レイヤー、runs)。この agent をメンバーとしてリストしているすべてのユーザー宣言 Topology にカスケードします。削除される agent がリーダーの team Topology は完全に削除されます。

reyn agent rm researcher --yes

default agent は削除できません。

Workspace レイアウト

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

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

関連情報