Skip to content

AyniReproducible quality evidence for AI-edited repositories

Commit policy, run repository tools in a locked environment, and give humans and agents the same scoped evidence.

The core model ​

Ayni keeps these responsibilities separate and reviewable:

  1. Define policy. .ayni.toml selects languages, signals, thresholds, structural rules, and optional runtime capabilities.
  2. Lock execution. .ayni.lock records exact tools, native dependency inputs, preparation state, and an immutable base image.
  3. Measure code. check, verify, and impact run measure the current workspace and produce normalized evidence.

Installing the CLI is separate from provisioning a repository environment. Ayni never silently creates a lock or rebuilds an image during a quality run.

Start with a reviewable proposal ​

After installing Ayni, configure the environment certificate signing variables used by env build:

sh
ayni init --dry-run
ayni init --write
ayni env show
ayni env lock
ayni env build
ayni check

init proposes a minimal test-only policy from adapter-owned project discovery; it never guesses thresholds and --write refuses to overwrite existing policy.

Commit .ayni.toml, .ayni.lock, and your native dependency/tool locks. Keep .ayni/ and the generated OCI image local.

Follow the complete quickstart →

A quality loop for humans and agents ​

Use a focused command while developing:

sh
ayni verify test
ayni impact run --base origin/main

Then run the complete repository contract before integration:

sh
ayni check

These commands run in the current workspace. A built Ayni image supplies locked tools when a platform starts it with an attached checkout.

Supported language adapters ​

LanguageManaged project shapeAdapter guide
RustCargo projects and workspacesRust
Nodenpm and pnpm projects and workspacesNode
GoGo modules and workspacesGo
Pythonuv projects and workspacesPython
KotlinSupported Gradle projects and workspacesKotlin

Unsupported project variants fail explicitly. Signal depth also varies: consult the adapter capability matrix.