agents

Overview

snippbot agents list                         # List agents + workspace version (v1/v2)
snippbot agents show <name>                   # Inspect one agent's workspace
snippbot agents migrate                       # v1→v2 migration (dry-run by default)
snippbot agents migrate --no-dry-run          # Actually rewrite workspace files
snippbot agents reflect <name>                # Force a reflection pass

Agent workspaces moved from the v1 layout (PERSONA.md, PROFILE.md, BEHAVIORS.md, SKILLS.md) to the v2 layout (IDENTITY.md, NOTES.md). These commands inspect that state and run the migration.

---

snippbot agents list

List every discoverable agent and whether its workspace is v1 or v2 (detected by the presence of IDENTITY.md).

snippbot agents list

---

snippbot agents show

Show one agent’s workspace: its path, evolution mode, files (with v1/v2 markers), and any pending memory writes.

snippbot agents show <name>

Argument	Description
name	Agent id to inspect

---

snippbot agents migrate

Run the v1→v2 workspace migration script. Defaults to a dry run that prints the proposed changes without writing.

snippbot agents migrate                  # dry-run (default)
snippbot agents migrate --no-dry-run     # apply changes
snippbot agents migrate --agent <name>   # limit to one agent

Option	Default	Description
--dry-run / --no-dry-run	--dry-run	Print proposed changes vs. actually rewrite files
--agent <name>	all	Only migrate the named agent

---

snippbot agents reflect

Force a reflection pass on the agent’s most-recent conversation (requires the local daemon’s dependencies).

snippbot agents reflect <name>

Argument	Description
name	Agent id whose latest conversation to reflect on