reflect-mcp 0.3.1

Reflection's autonomous runtime — wake, read prior state, do useful work, write back, sleep.

reflect

Autonomous agent runtime. Wake, read prior state, do useful work, write back, sleep.

Reflect runs on the Claude Agent SDK and is designed to operate continuously in the background — scheduling itself, reading inbox messages, executing work across independent tracks, and persisting state between sessions.

Install

uv tool install reflect-mcp
# or
pip install reflect-mcp

Quick start

reflect init my-project
cd my-project
reflect wake start main

MCP server (IDE integration)

The MCP server binary is reflect-manage (not reflect-mcp). Wire it in ~/.claude.json:

{
  "mcpServers": {
    "reflect": {
      "command": "reflect-manage",
      "env": {
        "REFLECT_PROJECT": "/absolute/path/to/your/project"
      }
    }
  }
}

REFLECT_PROJECT tells the MCP server which project to route state to. Without it, operations write to the uv install directory, not your workspace.

What's in the box

• reflect — CLI: init, wake, track, project, inbox, and more
• reflect-wake — wake loop runner (invoked by cron or reflect wake start)
• reflect-manage — MCP server for IDE integration (see above)
• reflect-dispatch — cron dispatcher (per-track scheduling)

Status

v0.3 is alpha. APIs and config formats will change.

License

MIT