Skip to main content

​
Profiles

Profiles let you run multiple independent agent configurations from one Headmaster installation. Each profile has its own personality, memory, skills, model defaults, and channel connections.

​
What a profile is

A profile is a complete, isolated agent configuration: Provider keys, MCP servers, and integrations are global because they’re infrastructure — you don’t want to re-enter your API keys for every profile.

​
Creating a profile

1

Open Manage profiles

Go to Settings → My Headmaster → Profile → Manage profiles.
2

Click Create profile

Enter a name (e.g., “work”, “personal”, “research”).
3

Configure

Choose whether to seed it with built-in skills. The new profile starts with a blank personality, empty memory, and no channel connections.
4

Switch to the new profile

Pick it from the profile selector in the sidebar or the specialist picker.

​
Switching profiles

Switch from:
  • The sidebar — click the profile name at the top, pick a different one.
  • The specialist picker — the profile selector is next to the specialist dropdown.
  • Slash command — /profile <name> in the composer.
When you switch, the sidebar reloads with the new profile’s conversation history, model defaults change, and the personality updates.

​
Use cases for multiple profiles

  • Work profile: Professional tone, connected to Slack and email, scheduled tasks for daily reports, memory focused on work projects.
  • Personal profile: Casual tone, connected to Telegram and iMessage, memory focused on personal preferences, no scheduled tasks.
Each family member or team member gets their own profile — their own Telegram bot (or shared bot with different trigger words), their own memory and personality. The agent treats each person differently.
  • Research profile: Connected to academic databases, uses The Researcher specialist, deep memory of research topics.
  • DevOps profile: Connected to servers via SSH, uses The DevOps specialist, scheduled tasks for monitoring.
  • Content profile: Uses The Writer and The Wordsmith, connected to social media integrations.

​
Profile model fallback

Each profile can specify a primary model and a fallback. If the primary is unavailable (provider outage, all keys rate-limited), the runtime falls back to the secondary automatically.
Configure in Settings → My Headmaster → Profile → Model fallback.

​
Profile-specific scheduled tasks

Scheduled tasks belong to a profile. When you create a task, it runs under the current profile’s configuration — that profile’s specialist, model, memory, and channel connections. If you switch profiles, you see only that profile’s scheduled tasks in the Schedule page.

​
Deleting a profile

1

Open Manage profiles

Go to Settings → My Headmaster → Profile → Manage profiles.
2

Select and delete

Click the profile, then Delete profile. Confirm.
Deleting a profile permanently removes all its conversations, memory, scheduled tasks, custom specialists, and channel connections. This cannot be undone. The default profile cannot be deleted.

Personality & Voice

Give each profile its own SOUL.md personality file.

Channels

Channel connections are per-profile — each profile can have its own messaging bots.