Metadata-Version: 2.4
Name: reflect-mcp
Version: 0.3.11
Summary: Reflection's autonomous runtime — wake, read prior state, do useful work, write back, sleep.
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: aiohttp>=3.9
Requires-Dist: anthropic>=0.100.0
Requires-Dist: claude-agent-sdk>=0.1.75
Requires-Dist: croniter>=2.0
Requires-Dist: fastapi>=0.115
Requires-Dist: httpx>=0.27
Requires-Dist: numpy>=2.4.4
Requires-Dist: pandas>=3.0.2
Requires-Dist: playwright>=1.59.0
Requires-Dist: plotly>=5.0
Requires-Dist: pyyaml>=6.0.3
Requires-Dist: rich>=13.0
Requires-Dist: shellingham>=1.5
Requires-Dist: textual<1.0,>=0.63
Requires-Dist: typer>=0.12
Requires-Dist: uvicorn[standard]>=0.32
Description-Content-Type: text/markdown

# 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

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

## Quick start

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

## Wiring into Claude Code

Add to `~/.claude.json`:

```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:

```json
"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
