Skip to main content
The SOUL.md file defines your agent’s personality, core truths, and boundaries. Place it inside your workspace directory alongside AGENTS.md and the agent will load it as part of its identity.

Where to Use

You can use SOUL.md with:

How It Works

  1. Create a file called SOUL.md in your workspace folder (same folder as AGENTS.md)
  2. Set the workspace parameter on your agent to point to that folder
  3. The agent reads SOUL.md when instructed by AGENTS.md (e.g. “Read SOUL.md — this is who you are”)

Template

Copy and customize this template for your use case: