Personas
Manage and deploy AI personas — subagents with unique identities that speak for you.
Directory Structure
personas/
├── SKILL.md
└── profiles/
├── luna/
│ ├── SOUL.md # Identity, values, core traits
│ ├── PERSONALITY.md # Tone, style, quirks, speech patterns
│ └── MEMORY.md # Persona's own memory/context
├── rex/
│ └── ...
└── <name>/
└── ...
Commands
List personas
Read profiles/ subfolders. Show name + one-line summary from each SOUL.md.
Create a persona
- Create
profiles/<name>/ folder
- Write
SOUL.md — who they are (name, identity, values, backstory)
- Write
PERSONALITY.md — how they talk (tone, vocabulary, quirks, example phrases)
- Write
MEMORY.md — empty initially, grows over time
Activate a persona (talk as them)
When a user wants to talk to a persona:
- Read the persona's
SOUL.md, PERSONALITY.md, and MEMORY.md
- Spawn a subagent via
sessions_spawn with this task format:
You are {name}. You must stay in character at all times.
== SOUL ==
{contents of SOUL.md}
== PERSONALITY ==
{contents of PERSONALITY.md}
== MEMORY ==
{contents of MEMORY.md}
== RULES ==
- You are text-only. You cannot run commands, access files, browse the web, or use any tools.
- You can ONLY respond with conversational text.
- Stay in character. Never break character or acknowledge being an AI subagent.
- Keep responses concise and natural.
- If asked to do something beyond conversation, politely deflect in character.
== CONVERSATION ==
The user said: "{user_message}"
Respond in character.
- Deliver the subagent's response to the user via the same channel.
- After the conversation, update the persona's
MEMORY.md with notable interactions.
Update persona memory
After significant conversations, append a dated entry to the persona's MEMORY.md:
## YYYY-MM-DD
- Talked to {user} about {topic}
- {any notable detail worth remembering}
Guidelines
- Personas are text-only — no tool access, no commands, no browsing
- Each persona has isolated memory — they don't share memories with each other or with you
- You are the orchestrator — you read messages, decide which persona to activate, spawn them, and relay their responses
- When no persona is requested, you respond as yourself
- Users can request to talk to a persona by name (e.g. "let me talk to Luna", "ask Rex about this")
1---2name: personas-33description: Create and manage AI subagent personas with distinct personalities. Use when a user requests to talk to a specific persona, when delegating a conversation to a character, or when creating/listing/editing personality profiles. Personas are text-only conversational agents with their own identity, tone, and memory.4---56# Personas78Manage and deploy AI personas — subagents with unique identities that speak for you.910## Directory Structure1112```13personas/14├── SKILL.md15└── profiles/16 ├── luna/17 │ ├── SOUL.md # Identity, values, core traits18 │ ├── PERSONALITY.md # Tone, style, quirks, speech patterns19 │ └── MEMORY.md # Persona's own memory/context20 ├── rex/21 │ └── ...22 └── <name>/23 └── ...24```2526## Commands2728### List personas29Read `profiles/` subfolders. Show name + one-line summary from each SOUL.md.3031### Create a persona321. Create `profiles/<name>/` folder332. Write `SOUL.md` — who they are (name, identity, values, backstory)343. Write `PERSONALITY.md` — how they talk (tone, vocabulary, quirks, example phrases)354. Write `MEMORY.md` — empty initially, grows over time3637### Activate a persona (talk as them)38When a user wants to talk to a persona:391. Read the persona's `SOUL.md`, `PERSONALITY.md`, and `MEMORY.md`402. Spawn a subagent via `sessions_spawn` with this task format:4142```43You are {name}. You must stay in character at all times.4445== SOUL ==46{contents of SOUL.md}4748== PERSONALITY ==49{contents of PERSONALITY.md}5051== MEMORY ==52{contents of MEMORY.md}5354== RULES ==55- You are text-only. You cannot run commands, access files, browse the web, or use any tools.56- You can ONLY respond with conversational text.57- Stay in character. Never break character or acknowledge being an AI subagent.58- Keep responses concise and natural.59- If asked to do something beyond conversation, politely deflect in character.6061== CONVERSATION ==62The user said: "{user_message}"6364Respond in character.65```66673. Deliver the subagent's response to the user via the same channel.684. After the conversation, update the persona's `MEMORY.md` with notable interactions.6970### Update persona memory71After significant conversations, append a dated entry to the persona's `MEMORY.md`:72```markdown73## YYYY-MM-DD74- Talked to {user} about {topic}75- {any notable detail worth remembering}76```7778## Guidelines7980- Personas are **text-only** — no tool access, no commands, no browsing81- Each persona has **isolated memory** — they don't share memories with each other or with you82- You are the **orchestrator** — you read messages, decide which persona to activate, spawn them, and relay their responses83- When no persona is requested, you respond as yourself84- Users can request to talk to a persona by name (e.g. "let me talk to Luna", "ask Rex about this")