# pmstate

> Project state as a first-class primitive; snapshot it, diff it, reason about it.

- Type: open source component
- Status: v0.4.0 · PyPI
- License: MIT
- Language: Python
- Repository: https://github.com/matshoppenbrouwers/pmstate
- Author: Mats Hoppenbrouwers (hoponthestack)
- Canonical URL: https://www.frameworkreboot.com/products/pmstate

A tiny Python library for agent-driven processes that live on the filesystem. Each node in your process tree owns a slice of state on disk, an append-only event log or a JSON table. The agent navigates, reads, spawns, and prunes the same way a human navigates a project folder.

## Writing and releases

- [Operational efficiency is a design problem, not a tooling problem](https://www.frameworkreboot.com/writing/operational-efficiency-is-a-design-problem-not-a-tooling-problem) (Jun 2026): Most teams already have the tools they need. What they are missing is a shared model of the work.

## Glossary

- [Process tree](https://www.frameworkreboot.com/glossary/process-tree): In pmstate, the directory tree itself: each node owns a slice of state on disk, as an append-only event log or a JSON table.
