Profiles: who's at the keyboard.
A profile is the human side of the collaboration model. It carries what you've declared about yourself, what agents have learned about you, and your personal library — across every workspace and every project. One install can hold several profiles; agents always know who they're working with.
The pair of files
| File | What it is | Who writes it |
|---|---|---|
PROFILE.md |
What you declare: role, context, how you like to work, what blunt feedback means to you. | You. Agents read it and never edit it. |
MEMORY.md |
What agents learn: durable preferences you've stated or clearly demonstrated across sessions. | Agents — conservatively. You can review, edit, or delete any line. |
The separation is a trust boundary: your self-description never drifts because an agent editorialized it, and the agents' notebook about you is clearly labeled as exactly that. Profile memory has a deliberately higher bar than project memory — stated preferences, not inferences about your mood.
What lands here vs. in a project
Agents sort with one question: "Would this still be true in a different project?" Yes → profile memory ("prefers two options, not five"). No → project memory ("the bridge comes before the final chorus"). See Projects & Memory.
Your personal library
A profile has its own documents/ — reference docs that are yours
rather than the workspace's. They're listed for agents, but primarily used on
your initiative: @-mention one in chat to bring it into the work. See
Reference Docs.
Multiple profiles
Profiles are selected from the top nav; the app remembers the last active one and restores your workspace and project context per profile. Use separate profiles for genuinely separate people — or separate personas, if your songwriting self and your consulting self shouldn't share a memory.
Where it lives
core/profile_manager.py— profile roots, avatars, lifecycle.core/project_manager.py— active-profile state and settings.- Profile root on disk —
PROFILE.md,MEMORY.md,documents/, per-workspace profile state.