Skip to main content
The USER.md file holds what your agent knows about the person it’s helping — name, preferences, context. Place it inside your workspace directory and the agent can read and update it to personalize assistance.

​
Where to Use

You can use USER.md with:

​
How It Works

  1. Create a file called USER.md in your workspace folder (same folder as AGENTS.md and SOUL.md)
  2. Set the workspace parameter on your agent to point to that folder
  3. The agent reads USER.md when instructed by AGENTS.md (e.g. “Read USER.md — this is who you’re helping”) and can update it as it learns about the user
from upsonic import Agent, Task

agent = Agent(
    "anthropic/claude-sonnet-4-5",
    workspace="/path/to/my_agent_folder"  # USER.md lives here
)

​
Template

Copy and customize this template for your use case: 

# USER.md - About Your Human

_Learn about the person you're helping. Update this as you go._

- **Name:**
- **What to call them:**
- **Pronouns:** _(optional)_
- **Timezone:**
- **Notes:**

## Context

_(What do they care about? What projects are they working on? What annoys them? What makes them laugh? Build this over time.)_

---

The more you know, the better you can help. But remember — you're learning about a person, not building a dossier. Respect the difference.