Skip to content
memhtml

memhtml head snapshot

View as MarkdownOpen in ChatGPTOpen in ClaudeOpen in Claude CodeOpen in Cursor

1. Synopsis

Write the version at HEAD as .memhtml/snapshots/<sha>.arrow, the cold-start cache, pruning to the newest four, or read that file back and report it. Every ref-moving commit writes this file itself; the command is for a store whose HEAD moved by other means.

Terminal window
memhtml head snapshot [options]

2. Arguments

This command takes no positional arguments.

3. Flags

Flag Type Default Values Description
--write flag false no fixed set Build the head from git and write its snapshot. Exactly one of --write / --read.
--read flag false no fixed set Open HEAD’s snapshot and report its row count and sha. Exactly one of --write / --read.

Every command also accepts the global flags.

4. Response

On success the command writes one JSON envelope to stdout, and its type is head.snapshot.

On failure it writes the failure envelope, whose code comes from error codes.

The JSON envelope gives the fields both shapes carry. Response types lists every value type takes across the binary.

5. Further reading

No guide block names this command. The guide is the workflow prose the CLI ships beside the command table: which command to reach for, and in what order.

6. Provenance

A loader generates this page from apps/cli/src/commands.ts while the site builds, so no file in the repository holds it: the COMMANDS array there is the one source of argument parsing, of memhtml manifest, and of AGENTS.md. Change the registry and this page changes with it.