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: stabilizing toward 1.0 — released surfaces are frozen
contracts; pin a version when you depend on it.

Install

One-line installer (macOS / Linux) — detects your platform, verifies the
SHA-256 checksum, and drops grim onto your PATH:

curl --proto '=https' --tlsv1.2 -LsSf https://setup.grimoire.rs/sh | sh

On Windows (PowerShell 7.4+):

irm https://setup.grimoire.rs/ps1 | iex

In GitHub Actions, use grimoire-rs/setup-grimoire@v1.
Pre-built binaries for macOS, Linux, and Windows (aarch64 / x86_64) are on
the latest release; other methods (ocx, source build) are in the
installation docs. Or build from source:

cargo install --git https://github.com/grimoire-rs/grimoire grimoire

Quick Start

grim init                                        # create grimoire.toml
grim add ghcr.io/grimoire-rs/skills/grim-usage   # declare, lock, install
grim install                                     # re-materialize after a clone
grim tui                                         # browse the index

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.