Python SDK Reference

Full API reference coming soon.

Installation

pip install writ-vcs

Quick Reference

Repository

import writ

# Open an existing writ repository
repo = writ.Repository.open(".")

# Initialize a new repository
repo = writ.Repository.init("/path/to/project")

Sealing

result = repo.seal(
    summary="added auth endpoint",
    agent_id="dev-1",
    agent_type="agent",
    spec_id="auth",
    status="in-progress",
    tests_passed=12,
    tests_failed=0,
)

Context

# Full context
ctx = repo.context()

# Scoped to a spec
ctx = repo.context(spec="auth")

Convergence

report = repo.converge_all(strategy="escalate", apply=True)

Verification

result = repo.verify_chain()
result = repo.verify_seal("a7c2e8f4b31a")

See the Getting Started guide for usage examples.