Skip to content
All guides
Guides Meet your agent Agent files

Agent files overview

Your agent is not hidden in a server. It is a folder of plain files on your computer. The Divergent Starter Pack builds on the OpenClaw-style agent template idea: make the agent's instructions, memory, and working notes visible enough that you can inspect them.

You do not need to memorize these. This map just helps you know what you are looking at when you open the workspace in Obsidian or a file browser.

The file you are looking for

If you are trying to start your agent and you are not sure which folder to pick, choose the folder that contains AGENTS.md, MEMORY.md, and knowledge-base at the top level.

Startup and instructions

These files tell the harness how to become your agent when a session starts.

AGENTS.md

The main instruction file. Codex reads this to learn how to behave in your workspace.

CLAUDE.md

The Claude Code entry point. It points Claude to AGENTS.md so both harnesses share the same core instructions.

BOOTSTRAP.md

The first-run checklist. As long as this file exists, onboarding is unfinished and your agent resumes from the first unchecked step.

README.txt

The tiny reminder at the front door: open this folder in your harness, say hi, and let the agent start.

Identity

These files give the agent a stable sense of who it is and who it is helping.

SOUL.md

Who your agent is, where it came from, and the principles it should follow.

IDENTITY.md

Your agent's name, vibe, creature, emoji, and optional avatar.

USER.md

A short profile of you: name, pronouns if you want them, timezone, and quick context.

Memory and knowledge

These are how the agent keeps continuity between sessions without trapping your life in an app you cannot leave.

MEMORY.md

Curated long-term memory: the distilled things your agent should keep carrying forward.

memory/YYYY-MM-DD.md

Daily session notes. Your agent appends what happened today so future sessions can pick up the thread.

knowledge-base/

Durable notes about people, organizations, projects, tools, and other entities in your life.

Tools, settings, and private files

These support the everyday workspace: dashboards, recurring notes, environment details, and optional integrations.

knowledge-base/Tools/

Your Daily Planner, Habit Tracker, Recurring Tasks, and dashboard support files.

TOOLS.md

Local setup notes your agent may need: device names, preferred voices, paths, and other environment-specific details.

HEARTBEAT.md

Optional periodic check instructions. Leave it empty unless you want the agent to check something in the background.

credentials/

A place for private local credentials when you deliberately add integrations. Do not share this folder.

.obsidian/

Obsidian vault settings and plugins, including the setup that makes your dashboards work.

Be careful with credentials and memory. Your workspace is yours, but it may contain private context over time. Do not paste it into public chats, and do not share folders like credentials/ unless you know exactly what is inside.

Where Obsidian fits

Obsidian is just a friendly way to read and edit this folder. The agent can work without Obsidian, but Obsidian makes the planner, habit tracker, knowledge base, and memory files much easier for humans to browse. Start with Edit your workspace in Obsidian when you are ready.

Stuck or need help?

Send a message and it comes straight to me. Tell me where you got stuck and I'll write back.

Rather have it done for you?

If following the steps yourself isn't how your brain works today, that's fine. On a Zoom call you share your screen and hand me control, and I set it up for you, right there on your own computer. You watch it come together and end the call with a working setup, nothing left on your plate.

Pick a time below. No pitch, no pressure, no homework beforehand.