Skip to content

/rhiza:status

Show the current rhiza sync status for the repo. Read-only; no scoring, no fixes, no issues.

/rhiza:status [path to a repo root] [--files] [--check]

The optional argument is the repo root to inspect; it defaults to the current repo.

What it does

Runs the bundled scripts/status.py — a stdlib-only read of .rhiza/template.lock — and reports:

  • the template repository and ref,
  • the synced commit SHA and timestamp,
  • the sync strategy,
  • the templates / paths that were materialized.

Pass --json for a machine-readable object whose fields mirror rhiza status --json. Pass --files (alias --tree) to append the managed files as a directory tree — the view the retired /rhiza:tree command used to give. Pass --check to compare the pinned ref against the latest upstream release and print whether you're up to date or N releases behind.

Notes

  • Works without the rhiza CLI (and without PyYAML) — it reads the lock directly.
  • If no template.lock is present the repo hasn't been synced yet; that's a hint, not an error.
  • --check is the only option that needs network: it runs git ls-remote --tags (no gh, no auth for public repos). A git or network failure is reported, not fatal. Use /rhiza:update to actually apply a newer release.