Living Repositories

Living Repositories guide

Runnable examples of the Living Repositories Protocol. Each example is a directory you can copy into your own repository.

Examples

Example Capabilities Isolation State target
_template run_tasks, publish_state dedicated-vm control-process
hello run_tasks, publish_state sandbox-process file
snapshot run_tasks, snapshot_restore sandbox-process control-process

Generated from each example’s manifest by scripts/gen_readme.py.

Add a manifest to your repository

  1. Copy examples/_template/.living/manifest.yaml into your repository as .living/manifest.yaml.
  2. Set project_id and the capabilities your agent needs. Field rules: schema reference.
  3. Validate it in CI:
- uses: actions/checkout@v7.0.1
- uses: ao3575911/living-repos-protocol@v0.4.0
  with:
    manifests: .living/manifest.yaml

Background

Source: github.com/ao3575911/living-repos.