leji (Python)

Reference SDK and CLI for the Leji specification: the open specification for the shared context layer of AI-native teams.

pip install leji        # or: uv tool install leji / pipx install leji
leji init               # bootstrap a context layer interactively
leji validate           # manifest, artifacts, frontmatter, lint rules
leji index              # generate the context index
leji index --check      # fail when the index is stale
leji changelog check    # append-only discipline
leji freshness          # review-horizon report
leji conformance        # score the layer against its claimed level
leji badge              # write the self-attested conformance badge and its markdown
leji status             # unindexed, dangling, and stale documents
leji route              # the governed context a task's scope routes to
leji viewer             # generate the static viewer for the context layer
leji viewer build       # export a self-contained static viewer folder
leji viewer serve       # generate, then serve it locally
leji view               # generate, serve, and open it in your browser
leji detect             # find installed agent hosts
leji start              # open the layer in a detected agent host
leji adopt              # map an existing entrypoint into a context layer
leji ci                 # add a validate workflow (--provider github|gitlab|circleci|azure)
leji agent --name <n>   # bind an additional named agent into the layer
leji mounts hydrate     # materialize declared federation mounts into the resolver cache
leji mounts status      # each mount's availability, integrity, and pin ancestry
leji mounts locate      # resolver state for one mount: projection path, pin, verification
leji mounts update-pin  # move one mount's pin, checked against the local witness (--fetch: the source)
leji changelog compact  # fold the oldest changelog entries into one compaction entry

See the full command reference (flags, exit codes, examples) at https://leji.org/cli/.

Inside a repository that declares leji, has a project environment inside the repository (.venv, or uv's UV_PROJECT_ENVIRONMENT) with a copy meeting the layer's minimum, leji runs that copy; set LEJI_NO_LOCAL to any value to run this one.

Behaviorally identical to the @leji-org/leji npm package and the Go SDK: same commands, same flags, same findings, same exit codes (0 clean, warnings included; 1 a check that did not pass, with or without a finding; 2 a usage error or an internal failure); the one runtime-specific behavior is the hand-off above, which the Node and Python CLIs perform and the Go CLI does not (there, run the pinned copy with go tool leji). All three implementations are tested against one shared fixture suite. Install whichever matches your toolchain; agents and CI see the same tool either way.

Supports spec line 1.0. Schemas and templates for that line ship inside the package; no network access is needed.

• Specification: https://leji.org
• Source: https://github.com/leji-org/leji (packages/sdk-py)
• License: Apache-2.0