reflect-mcp 0.4.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

Wiring into Claude Code

Add to ~/.claude.json:

{
  "mcpServers": {
    "reflect": {
      "command": "reflect-manage"
    }
  }
}

Then restart Claude Code. The reflect MCP tools (track, track_admin, project, wake, inbox, doctor, cost) will be available.

Note: reflect-manage is the MCP server binary. reflect-serve is unrelated (FastAPI landing page).

Project root resolution: reflect-mcp walks up from your shell's cwd looking for a directory containing agent/runtime/tracks/. Launch Claude Code from your project directory and reflect will route there automatically. To force a specific project regardless of cwd, set REFLECT_PROJECT in the MCP server's env:

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

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