GhostPaw Grimoire
Versioned agent skills as SKILL.md folders with git history, rollback and evidence notes
- 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/grimoireAdd to claude_desktop_config.json
{
"mcpServers": {
"grimoire": {
"command": "npx",
"args": [
"-y",
"@ghostpaw/grimoire"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"grimoire": {
"command": "npx",
"args": [
"-y",
"@ghostpaw/grimoire"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools