anvil-state
Local-first project state engine: turn rough ideas and PRDs into reviewed, lockable, evidence-backed work packets that humans and AI coding agents can coordinate on without conflicts.
anvil-state installs the anvil CLI and the anvil-mcp MCP server.
Current release: v0.6.5 (schema 21, public API contract 14). The release adds revision-safe PRD lifecycle gates, transactional Git claims, bounded provider reads, scoped task routing, and faster no-UAC Windows test feedback; see the full changelog.
Runtime compatibility: the published package requires Python 3.11+, Pydantic 2.11.7+, and FastMCP 3.x (3.0.0 or newer). These are the lowest versions that both resolve and provide Anvil's MCP registration and surface-gating APIs; the next FastMCP major remains opt-in until qualified.
The immutable version-1 provider-read ceilings and exact limit-refusal shape
are published in the packaged _data/provider-read-contract-v1.json fixture;
the runtime pins its canonical-JSON SHA-256 so line-ending conversion cannot
mask or invent drift from the validated anvil.read_contracts models.
uv tool install anvil-state # or: pipx install anvil-state
anvil --help
anvil install <harness> # wire anvil into Codex, Cursor, VS Code, ...
The MCP server (anvil-mcp) exposes anvil's tool surface to any MCP-capable
harness. anvil install <harness> writes the MCP config and instruction file for
a target harness (idempotent, backed up, reversible with --rollback).
Full documentation, the cross-harness install guide, and the Claude Code plugin live in the repository: https://github.com/fakoli/anvil
1 maintainer
Release files for anvil-state 0.6.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| anvil_state-0.6.8.tar.gz | 899.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| anvil_state-0.6.8-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.8 MB
Release files / anvil_state-0.6.8.tar.gz
| Download URL | anvil_state-0.6.8.tar.gz |
|---|---|
| Size | 899.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ad39198d9d7618232fe7144930eb8cfb6045ef437045366c31d5d1a1615a0862
|
|
BLAKE2b-256 checksum How to use checksums |
6b58d3777efe73928b24e63bd0d5756fb1055584e1986a4228b2fa9990b31952
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 12, 2026.
Transparency logRelease files / anvil_state-0.6.8-py3-none-any.whl
| Download URL | anvil_state-0.6.8-py3-none-any.whl |
|---|---|
| Size | 862.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ee348579a1b9bda6bb372f5da728ec37c3c0dad0ee715e4ee4575a1923edb93a
|
|
BLAKE2b-256 checksum How to use checksums |
37421d6762c9e6e57dfec85f9f8b4e0047dd75ee00a73daf75a1bae63e6280a4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 12, 2026.
Transparency log
