grimoire-rs/grimoire

<div align="center"

<img src="./assets/logo.png" width="192" /

grimoire

A package manager for AI-agent config — skills, rules, agents, and MCP servers, installed into every coding agent you use

</div

Declare a skill once and grim writes it into Claude Code, Copilot, Cursor, Codex, Gemini, Zed, Amp, Kiro, Junie, and opencode — each in the format that client actually reads, pinned by digest in a lockfile. Storage is any OCI registry — GHCR, Docker Hub, or your own. There is no Grimoire service to sign up for.

Where a client has no honest surface for an artifact, grim says so and skips it rather than writing config that looks installed and does nothing. See the [client compatibility matrix][docs-clients].

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][setup-grimoire]. Pre-built binaries for macOS, Linux, and Windows (aarch64 / x8664) are on the [latest release][releases]; other methods (ocx, source build) are in the [installation docs][docs-install]. 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][docs].