0.4.0 - 2026-06-11

Release Notes

Added

• Allow non-version tags without cascade (release)
• Infer artifact kind from manifest annotation (oci)
• Replace editor option with clients array (config) BREAKING
• Infer kind, optional name, honor default registry (add)
• Discriminate artifact kind by OCI artifactType (oci) BREAKING
• Support multi-file rules with a sibling support dir (install)
• In-file metadata with summary column and width-aware search (catalog)
• Render skills and rules per client with vendor env overrides (install)
• Shared multi-term matcher for CLI and TUI, tui --refresh (search)
• Detect installed clients and centralize registry precedence (clients)
• Flat kind-sorted list, shared search matcher, clients line (tui)
• Live background update checks for catalog and floating tags (tui)
• Add agent artifact kind with canonical frontmatter and packing (oci)
• Declare, hash, lock, and resolve agents (config,lock,resolve)
• Per-vendor agent materialization (install)
• Agent command surface and TUI parity (cli,tui)
• Cache bundle expansion and compute effective sets offline (lock,resolve)
• Authored repository metadata wins the source annotation (oci)
• Read back repository URL from the source annotation (catalog)
• Semantic detail pane with scrolling and o-to-open (tui)
• Page keys scroll the detail pane without focusing it (tui)
• Clamp detail scrolling at the content's end (tui)

Changed

• Drop dead effective_default_registry helper (command)

Documentation

• Update for clients array, new add CLI, non-version release tags
• Describe artifactType-based kind discrimination
• Document the rule support directory
• Align rig README, detection rule, env table, auth doc comments
• Document TUI declare/relock semantics
• Agent artifact reference and ADR
• Lock [[bundle]] cache and effective-declaration removal semantics
• Add artifact reference page
• Repository metadata key, source annotation, and TUI detail pane

Fixed

• Resolve catalog under namespaced default registry (catalog)
• Use authorized catalog endpoint of oci dep (oci)
• Harden background update checks and catalog merge (tui)
• Release global registry tier, dedup helper, clients display (command)
• Longest-term prefilter and visible catalog truncation (search)
• Surface catalog truncation on the legend line (tui)
• Generation-key in-flight dedup and stamp catalog refreshes (tui)
• Extract shared declare/undeclare seams (command)
• Declare installs in grimoire.toml, flip outdated badge fast (tui)
• Install bundles as bundles, not skills (tui)
• Keep shared bundle members on bundle removal (lock,resolve)
• Pack [agents] members of an authored bundle (build)
• Mutate the lock via before/after effective sets (remove,uninstall,tui)
• Recompute all row states after a batch operation (tui)
• Hold the config flock on a sidecar, not the file itself (lock)

Download grimoire 0.4.0

File	Platform	Checksum
grimoire-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
grimoire-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
grimoire-aarch64-pc-windows-msvc.zip	ARM64 Windows	checksum
grimoire-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
grimoire-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
grimoire-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum
grimoire-aarch64-unknown-linux-musl.tar.xz	ARM64 MUSL Linux	checksum
grimoire-x86_64-unknown-linux-musl.tar.xz	x64 MUSL Linux	checksum