Agent profile files
xopc creates a small set of Markdown files for each Agent. They make the Agent's identity and operating guidance readable and editable without changing application code.
Default location: ~/.xopc/agents/<agent-id>/profile/.
| File | What to put there |
|---|---|
| SOUL.md | Stable principles, tone, and values |
| IDENTITY.md | Name, role, description, language, and visible identity |
| TOOLS.md | Local tool hints that are safe for the Agent to know |
| AGENTS.md | Working rules, collaboration style, and red lines |
| HEARTBEAT.md | Short periodic-check guidance when Heartbeat is enabled |
Edit safely
- Back up the profile directory.
- Change one file at a time.
- Keep instructions short and unambiguous.
- Start a new Session and test a small request.
- Remove rules that duplicate or contradict each other.
Setup and xopc agents add create missing files but do not overwrite your existing profile Markdown.
What does not belong here
- API keys, passwords, tokens, or private SSH material;
- the user's personal profile or long-term memory;
- large reference documents that can live in the Agent workspace;
- frequently changing Task status.
Profile files may be sent to the configured model as Agent context. Treat everything in them as potentially visible to that model provider.
Use Agents for capability settings and Data and file locations for the difference between profile, workspace, and local state.