Metadata-Version: 2.4
Name: autoclaw
Version: 0.1.2
Summary: AutoClaw local-first workflow control plane
License: MIT
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click<9.0.0,>=8.1.6
Requires-Dist: rich<14.0.0,>=13.7.1
Requires-Dist: fastapi<1.0.0,>=0.115.12
Requires-Dist: uvicorn[standard]<1.0.0,>=0.34.0
Requires-Dist: sqlalchemy<3.0.0,>=2.0.40
Requires-Dist: pydantic<3.0.0,>=2.11.3
Requires-Dist: pydantic-settings<3.0.0,>=2.8.1
Requires-Dist: mcp<2.0.0,>=1.27.1
Requires-Dist: python-dotenv<2.0.0,>=1.1.0
Requires-Dist: httpx<1.0.0,>=0.28.1
Requires-Dist: platformdirs<5.0.0,>=4.3.7
Requires-Dist: aiosqlite<1.0.0,>=0.21.0
Provides-Extra: postgres
Requires-Dist: asyncpg<1.0.0,>=0.30.0; extra == "postgres"
Provides-Extra: dev
Requires-Dist: pytest<9.0.0,>=8.3.5; extra == "dev"
Requires-Dist: pytest-asyncio<1.0.0,>=0.26.0; extra == "dev"
Requires-Dist: pytest-cov<7.0.0,>=6.1.1; extra == "dev"
Requires-Dist: ruff<1.0.0,>=0.11.5; extra == "dev"
Requires-Dist: mypy<2.0.0,>=1.15.0; extra == "dev"
Requires-Dist: PyYAML<7.0.0,>=6.0.2; extra == "dev"
Requires-Dist: types-PyYAML<7.0.0,>=6.0.12.20250326; extra == "dev"
Requires-Dist: asyncpg<1.0.0,>=0.30.0; extra == "dev"
Dynamic: license-file

# AutoClaw

Status: Reference

Last verified: 2026-05-07

AutoClaw is a controlled agent runtime for multi-step work that must stay auditable, replayable, and operationally recoverable.

This root README is a front-door router only. Public docs live under `docs/`. Internal canon lives under `docs-internal/`.

## Start here

- Public docs map: [Public docs home](docs/README.md)
- Product narrative: [Product docs home](docs/product/README.md)
- Public reference: [Reference docs home](docs/reference/README.md)
- Internal canon: [Internal canon home](docs-internal/README.md)
- Coding-agent policy: [Coding agent contract](AGENTS.md)
- Coding standards: [Coding standards](STYLE.md)

## Repo shape

- `apps/api/` - backend API, runtime, DB, CLI, and tests
- `definitions/` - workflow and definition content used by owning phases
- `docs/` - public product and reference docs
- `docs-internal/` - internal design, current-contrast, execution, ADR, and archive canon
- `scripts/` - repo tooling, including docs validation under `scripts/docs/`
- `examples/` - example workflows and supporting artifacts

## Common verification lanes

- Unit backend suite: `make test-api-unit`
- Local integration verification: `make test-api-integration`
- Docker/Postgres verification: `make test-api-db`
- Docs freeze validation: `./.venv/bin/python -m scripts.docs.docs_freeze.cli`

## License

Licensed under MIT. See [LICENSE](LICENSE).

## Surface rule

Use this page for fast routing only.

Do not treat it as the authoritative source for detailed runtime behavior, target design contracts, or phase-closeout status.
