Metadata-Version: 2.4
Name: reflect-mcp
Version: 0.3.2
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
```

## MCP server (IDE integration)

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

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