grimoire

An OCI-backed package manager for AI skills and rules

grim installs, maintains, and publishes AI agent skills and rules using OCI registries (GHCR, Docker Hub, private registries) as storage — the same way container images are distributed. It is a backend tool: a building block for keeping agent configuration versioned, shareable, and reproducible.

Status: provisional, pre-1.0. The core CLI — init, add, lock, install, update, status, search, tui, build, release, remove, uninstall — is implemented and shipping in released binaries. The surface is still moving toward 1.0, so pin a version when you depend on it.

Install

Grab a pre-built binary for macOS, Linux, or Windows (aarch64 or x86_64) from the latest release, or build from source:

cargo install --git https://github.com/michael-herwig/grimoire grimoire

Quick Start

grim init --registry ghcr.io/acme                      # create grimoire.toml
grim add skill code-review ghcr.io/acme/code-review:1  # declare + lock
grim install                                           # materialize into your editor
grim tui                                               # browse the catalog

Full documentation: grimoire docs.

Development

See CONTRIBUTING.md for the full guide.

Prerequisites: Rust, task, uv (for the Python acceptance suite).

Community

• Code of Conduct
• Security Policy

License

Grimoire is licensed under the Apache License, Version 2.0.