1.2.0 - 2026-06-28
Release Notes
Turns memory.md into a deterministic agent startup briefing and adds a
release gate for startup-memory usefulness.
Added
- Latest Project State:
memd memory-mdnow starts with the resolved
tenant/project scope, project directory, generation time, git branch/dirty
summary, latest task or handoff signal, source-backed next actions, and
project-scoped memory readability warnings. - Agent-usefulness gate:
memd eval-memory-md --agent-usefulnesschecks
startup output for current project state, git state in git repositories, open
task next actions, sourced next actions, suppressed fragments, suppressed
boilerplate, and bounded machine-wide facts. - Gold-file evaluation:
memd eval-memory-md --gold-file <path>runs the
agent-usefulness gate across local multi-project fixtures. - Explain-output project state:
memory-md --explain-outputnow includes
structured project state, startup-quality flags, topic keys, and
agent-usefulness metrics for debugging noisy startup context.
Changed
- Startup fact libraries: the rendered sections are now
Project Fact LibraryandMachine-Wide Fact Library. Machine-wide facts default to two
items, while project facts are deduplicated by topic and filtered for
generated wrappers, continuation fragments, generic boilerplate actions, and
unrelated machine-wide records. - Session-start defaults:
memd session-startuses the same capped
machine-wide fact default asmemory-md. - Memory health scan: project-scoped readable/unreadable counts are bounded
for session-start use and report a partial-scan warning instead of doing
unbounded payload reads.
Install memd 1.2.0
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/fmschulz/memd/releases/download/v1.2.0/memd-installer.sh | shDownload memd 1.2.0
| File | Platform | Checksum |
|---|---|---|
| memd-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| memd-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| memd-aarch64-unknown-linux-musl.tar.xz | ARM64 MUSL Linux | checksum |
| memd-x86_64-unknown-linux-musl.tar.xz | x64 MUSL Linux | checksum |