Project Files
INSTRUCTIONS.md
Four tools for managing character personas in LM Studio:
switch — Activate a persona by IDlist — List available persona profilesget — Show the currently active personasave — Create and save a new persona from the modelPersona profiles are stored as JSON files in the plugin's profiles/ directory.
switch Tool| Parameter | Type | Default | Description |
|---|---|---|---|
personaId | string (req) | — | Persona ID in kebab-case (e.g. "socrates"). Use "__default__" to reset |
list ToolNone.
get ToolNone.
save Tool| Parameter | Type | Default | Description |
|---|---|---|---|
name | string (req) | — | Display name (e.g. "Marie Curie") |
description | string (req) | — | Persona description / backstory |
systemPrompt | string (req) | — | System prompt for this persona |
greeting | string | — | Optional greeting message |
tags | string[] | — | Optional tags for categorization |
overwrite | boolean | false | Overwrite existing profile with same ID |
The ID is generated automatically from name:
[a-z0-9-])Example: "Marie Curie" → "marie-curie"
Profiles are stored as JSON files in profiles/:
switch with "__default__" to reset to the default assistant.save, the profile is immediately available for switch.get tool shows the current messageCount — useful for tracking conversation length.{
"previousPersona": "einstein",
"activePersona": {
"id": "socrates",
"name": "Socrates",
"description": "Classical Greek philosopher...",
"systemPrompt": "You are Socrates...",
"greeting": "Let us begin our inquiry..."
},
"contextReset": true
}
{
"personas": [
{
"id": "einstein",
"name": "Albert Einstein",
"description": "...",
"tags": ["physicist", "scientist"]
}
],
"count": 1
}
{
"active": true,
"persona": { "id": "einstein", "name": "Albert Einstein", ... },
"context": {
"activePersonaId": "einstein",
"activePersonaName": "Albert Einstein",
"systemPrompt": "You are Albert Einstein...",
"messageCount": 12
}
}
{
"id": "marie-curie",
"name": "Marie Curie",
"description": "Nobel Prize-winning physicist and chemist...",
"systemPrompt": "You are Marie Curie...",
"filePath": "D:\\...\\profiles\\marie-curie.json",
"success": true,
"overwritten": false,
"message": "Persona 'marie-curie' saved successfully."
}
{
"id": "einstein",
"name": "Albert Einstein",
"description": "Theoretical physicist who developed the theory of relativity.",
"systemPrompt": "You are Albert Einstein...",
"greeting": "Guten Tag! Let us explore the universe together.",
"tags": ["physicist", "scientist", "20th-century"]
}