Merlin

Merlin Docs

Docs

Merlin Claw is a minimal Go runtime for cwd-local agent work. The folder owns the identity: AGENTS.md, SOUL.md, agents/, skills/, clis/, and .claw/runtime/ are resolved from the cwd before a turn runs.

The product model is many cwd-rooted personas on one machine, with agents able to hand work to each other through rooms and mesh turns.

Current Shape

Surface What it gives the workspace
Extensions Workspace-local skills, CLIs, copied files, tool names, dashboard/MCP routes, and extension state.
MCP A cwd-bound server for external agents to run Claw turns, inspect sessions/resources, and use gated management tools.
Cron Scheduled prompts with run history, weekday schedules, explicit delivery, and channel-origin delivery.
Web UI Local management for chat, sessions, agents, skills, extensions, cron, SOUL, and installed Project Sessions.
Mesh Agent-to-agent handoffs inside rooms.

Next

Generative UI: workspace-specific screens built from the user’s workflow, so specialized tasks do not have to live inside one generic chat pane.

The Runtime Contract

Part What it means
Instance The resolved cwd plus its .claw/, agents/, skills/, clis/, AGENTS.md, and SOUL.md.
Identity An agent spec, optional prompt and SOUL files, skills, tool allowlist, model choice, and memory scope.
Workflow Durable runtime state: sessions, memory, cron, channels, rooms, extension state.
Channel CLI, TUI, web, Telegram, Discord, iMessage, Signal, webhook, cron, or mesh, all converging on the same runtime send path.

Folder Layout

AGENTS.md
SOUL.md
agents/
skills/
clis/
.claw/
  config.json
  extensions/
  runtime/
    sessions/
    memory/
    cron/
    channels/
    extensions/
    tasks/

AGENTS.md and SOUL.md describe the default persona. agents/ and skills/ add specialists and reusable capabilities. clis/ registers local CLIs as tools. .claw/ stores configuration and durable runtime state for that folder. Runtime paths such as tasks/ appear when the matching feature is used.

Philosophy One executable, many folder-local agents. Identities Agent specs define local personas, models, skills, tools, and memory scope. Memory Durable facts injected into future prompt stacks. Cron Local scheduled prompts with run history and optional chat delivery. Channels Web, TUI, CLI, Telegram, Discord, iMessage, Signal, webhook, cron, and mesh share the runtime. Skills Markdown capability files loaded into the prompt stack. Extensions Workspace-local bundles for skills, CLIs, copied files, tool names, and runtime state. Project Sessions Extension-managed Codex and Claude sessions grouped by repo. Operations Inspect, back up, install, update, and verify local Claw instances.