Merlin Docs
Philosophy
One executable, many folder-local agents.
Claw is intentionally small: one executable, explicit files, deterministic runtime state. The important move is that identity is local to a folder.
Why CWD Local
| Global assistant problem | Claw shape |
|---|---|
| One memory pool leaks across projects. | Memory is rooted under .claw/runtime/memory. |
| One personality must fit every repo. | Each cwd gets SOUL.md, AGENTS.md, and local agent specs. |
| Workflows live in chat history. | Cron, channels, rooms, extensions, and sessions are runtime files. |
| Tool access is broad by default. | Workspace and agent configs can restrict tools. |
What This Enables
- A work folder can have a review agent, triage cron, GitHub skill, and project-specific memory.
- A personal folder can have a different persona, different tools, and different schedules.
- A machine can run many identities without one agent absorbing every context.