ReferenceCLI

CLI: repository, evidence, and search

These commands maintain the evidence Memory Layer uses for retrieval, provenance, and graph-aware context. They are usually run after onboarding, large refactors, provider changes, or repository history imports.

CommandWritesPurpose
memory commitsYesImport and inspect git commit history.
memory repoYesBuild and inspect the repository index.
memory graphYesExtract and inspect the project code graph.
memory embeddingsYesRebuild and maintain embedding spaces.
memory bundleMixedExport and import shareable project memory bundles.

memory commits

Import git history when commit context matters for future questions.

memory commits sync --project memory
memory commits sync --project memory --limit 100 --dry-run
memory commits list --project memory --limit 20
memory commits show <commit-hash> --project memory

Commit sync is evidence, not curation by itself. Pair it with query, scan, or explicit memories when decisions should become durable project knowledge.

memory repo

The repository index records files and metadata used by scan and provenance workflows.

memory repo index --project memory
memory repo index --project memory --since 2026-04-01 --dry-run
memory repo status --project memory --json

Run it after major file moves or when scan/provenance output looks stale.

memory graph

The graph command extracts parser-backed code symbols, references, and edges.

memory graph extract --project memory
memory graph extract --project memory --force --text
memory graph status --project memory

Graph data helps query connect memory facts to code structure. It is especially useful after refactors where names or modules move without intended behavior changes.

memory embeddings

Embedding commands maintain semantic search spaces.

memory embeddings list
memory embeddings activate voyage-code
memory embeddings reindex --project memory --dry-run
memory embeddings reembed --project memory --backend voyage-code
memory embeddings prune --project memory --dry-run

Use list before rebuilds. reindex rebuilds chunks and embeddings, while reembed fills configured embedding spaces without rebuilding chunks.

memory bundle

Bundles move project memory between systems or preserve a point-in-time export.

memory bundle export --project memory --out memory.mlbundle.zip
memory bundle import --project memory ./memory.mlbundle.zip --dry-run

Review bundle contents before import. Treat bundles as sensitive project data.

© 2026 Olivier Van Acker (3vilM33pl3). Memory Layer is AGPL-3.0-or-later with commercial licensing available.

On this page