---
type: note
alexandria_core: true
author: alexandria
---

# Version

**What this vault is running.** Alexandria is the software; this note is its build stamp + feature list, regenerated from the installed version on every `alexandria update`. **This is Core — don't hand-edit it; it's overwritten on update.** To move to a newer Alexandria, use the `alexandria-update` skill.

## This build
- **Commit:** `{{ build.source_commit_short or "unknown" }}`{% if build.source_commit %} — full `{{ build.source_commit }}`{% endif %}{% if build.source_dirty %} · ⚠ built from a dirty working tree{% endif %}
- **Software version:** {{ build.software_version or alexandria.version or "unknown" }}{% if build.software_version %} · template_ref `v{{ build.software_version }}`{% elif alexandria.template_ref %} · template_ref `{{ alexandria.template_ref }}`{% endif %}
- **Source:** `{{ alexandria.source_repo or "keystone-computer/alexandria" }}` @ `{{ build.source_ref or alexandria.source_ref or "main" }}`
- **Rendered:** {{ today }}

## Features — modules enabled here
{% for m in modules_info.enabled %}- **{{ m.id }}**{% if m.version %} · v{{ m.version }}{% endif %} — {{ m.description }}{% if m.provides %} *(provides: {{ m.provides | join(", ") }})*{% endif %}
{% endfor %}{% if not modules_info.enabled %}*(The feature list is stamped by `alexandria init` / `update` — run one to populate it.)*
{% endif %}

## Available — not enabled here
{% for m in modules_info.available %}- {{ m.id }} — {{ m.description }}
{% endfor %}{% if not modules_info.available %}*(Every registered module is enabled — or the list is stamped on the next init/update.)*
{% endif %}

## Knowing what you run & upgrading
- **What am I running?** This note — regenerated each update — plus `alexandria status`, which reads the same commit from `.state/render.lock`. Read *this note*, never `.state/` directly.
- **Upgrade:** tell the agent to *"update yourself"* — the `alexandria-update` skill refreshes Core from `{{ alexandria.source_repo or "keystone-computer/alexandria" }}` and reports the `old → new` commit bump.
