Skip to content
MCP server

GhostPaw Grimoire

Versioned agent skills as SKILL.md folders with git history, rollback and evidence notes

Runs locallyStatus and history
Pricing
Open source
Platforms
Linux, macOS, Windows
Runs
Locally
Version
0.7.3
Listing updated
3 days ago

About GhostPaw Grimoire

GhostPaw Grimoire is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Grimoire answers the question of who keeps the history when an agent edits its own SKILL.md. Each procedure, which it calls a spell, is a folder on your disk, improvements are sealed as git commits inside the spell root, and evidence notes live in SQLite. A spell's rank counts its sealed commits, and rollback restores an earlier version for review.

The workflow is deliberately gated. A write validates that the file has proper frontmatter, a note from practice is stored as pending evidence, and an agent's edit stays uncommitted until somebody seals it. The site replays a deploy-service spell step by step from a real run to show this, and notes that the format check is not a security scan.

It ships as a single executable for Linux, macOS and Windows with zero runtime dependencies, or as an npm library needing Node.js 24 or newer. Paths are set through GHOSTPAW_GRIMOIRE_ROOT, GHOSTPAW_GRIMOIRE_GIT_DIR and GHOSTPAW_GRIMOIRE_DB, and a Dockerfile and MCP bundle are provided. It is MIT licensed.

Install

Run in a terminal

claude mcp add grimoire -- npx -y @ghostpaw/grimoire

Add to claude_desktop_config.json

{
  "mcpServers": {
    "grimoire": {
      "command": "npx",
      "args": [
        "-y",
        "@ghostpaw/grimoire"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "grimoire": {
      "command": "npx",
      "args": [
        "-y",
        "@ghostpaw/grimoire"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "grimoire": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ghostpaw/grimoire"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "grimoire": {
      "command": "npx",
      "args": [
        "-y",
        "@ghostpaw/grimoire"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "grimoire": {
      "command": "npx",
      "args": [
        "-y",
        "@ghostpaw/grimoire"
      ]
    }
  }
}

Configuration

  • GHOSTPAW_GRIMOIRE_GIT_DIRGit history directory (default: <ROOT>/.grimoire-git)
  • GHOSTPAW_GRIMOIRE_ROOTSpells directory (default: ~/.ghostpaw/grimoire/)
  • GHOSTPAW_GRIMOIRE_DBSQLite database path (default: ~/.ghostpaw/grimoire.db)

What it does

Spells as files
Procedures are SKILL.md folders on your own disk.
Git-sealed history
Each improvement is a commit that can be rolled back.
SQLite evidence notes
Notes from practice are kept as pending evidence until used.
Rank by commits
A spell's rank counts its sealed commits.
Single binary
One executable with zero runtime dependencies.
Configurable paths
Environment variables set the spell root, git directory and database.

Good for

  • Keep a revision history of skills an agent edits
  • Roll a procedure back to an earlier version for review
  • Record evidence notes from practice before changing a skill
  • Run a local skill library for Claude Code, Codex or Cursor

Pricing

Open source

Free, MIT licence

Prices change. Check grimoire.ghostpaw.dev before you buy.

GhostPaw Grimoire FAQ

Where is the data stored?

Spells are files on your disk, history is a git repository inside the spell root, and metadata is SQLite, defaulting to ~/.ghostpaw/grimoire.db.

What does it need to run?

The release binary includes its runtime. npm and library use need Node.js 24 or newer.

Does an agent's edit apply immediately?

No. The edit waits uncommitted until somebody seals it.

What licence is it?

MIT, with zero runtime dependencies.

Is GhostPaw Grimoire free?

Yes. GhostPaw Grimoire is open source, so you can use and self-host it for free.

How do I add GhostPaw Grimoire to Claude Code?

Run this command in your terminal: claude mcp add grimoire -- npx -y @ghostpaw/grimoire

What are the best alternatives to GhostPaw Grimoire?

The closest alternatives to GhostPaw Grimoire are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to GhostPaw Grimoire

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools