About this project

T3X is a version control system designed for structured state rather than code. It acts as a control plane that lets people and AI agents propose, validate, review, and commit changes to structured artifacts (typically YAML) while maintaining full provenance and reversible history. The core idea is that each state transition records the previous state, the proposed diff, checks, rationale, actor, and evidence, producing an auditable trail. T3X can render structured state into human-readable documents (e.g., technical PRDs) without losing the underlying source of truth. Key capabilities: - **Review before commit**: Inspect exact diffs before any history advances. - **Deterministic transitions**: Apply ordered, fail-fast operations via the YOps engine. - **Attached checks**: Use YSchema for validation and external checks without hiding failures. - **Provenance-rich decisions**: Each change ties together source, rationale, actor, and evidence. - **Reversible history**: Compare, branch, merge, and revert structured state without erasing prior changes. - **Unified path for humans and agents**: Agent proposals undergo the same review process as human changes. The project is in public alpha (v1.0.0). Its published npm surface includes four packages: - `@t3x-dev/local` – run T3X locally via a launcher. - `@t3x-dev/yops` – apply declarative YAML operations. - `@t3x-dev/transition` – verify protocol objects and commit integrity. - `@t3x-dev/yschema` – validate structured state and produce fixes. The WebUI, API, CLI, MCP integrations, runner, and storage remain internal or preview and may change. Quickstart options: - Local evaluation: `npx -p @t3x-dev/local t3x-local` - Development from source: clone the repository, run `pnpm install`, then `pnpm dev:api` and `pnpm dev:webui` (requires Node.js 20+ and pnpm 10+). - Self-hosted via Docker: copy `.env.example` to `.env` and run `docker compose up -d --build`. The system is licensed under Apache 2.0. More details are available in the [documentation](https://docs.t3x.dev), including guides on deployment, limitations, stability, security, and contributing.