Skip to main content
Identity files are special memory documents that are automatically injected into the LLM system prompt on every turn. They give the agent a consistent identity, behavioral instructions, and knowledge about you — persisting across sessions and restarts.

The Four Identity Files


Identity Files

Four special files are automatically injected into the LLM system prompt on every turn: All four files live in the workspace root and can be either manually edited by you, or written by the agent using the memory_write tool.

AGENTS.md

Behavioral instructions. What the agent should and should not do, how it should handle specific situations, and any workflow rules you want enforced.

SOUL.md

Values and personality. How the agent approaches problems, what it prioritizes, and what kind of assistant it aims to be.

USER.md

Information about you. The agent reads this file to understand your context, preferences, and working patterns without needing to ask repeatedly.

IDENTITY.md

A combined identity definition, often used to give the agent a specific role or persona for a particular workspace or project.

How Injection Works

At the start of every LLM call, the agent reads all four identity files from the workspace and prepends them to the system prompt:
Files that do not exist are silently skipped — you do not need all four. Start with whichever is most useful for your workflow.