Grimoire

grimoire

A prompt engineering toolkit for developers. Store prompts with version control, inject AI agent skills into projects, and manage parallel development with git worktrees.

Installation

Quick Install (Recommended)

curl -fsSL https://raw.githubusercontent.com/aaryareddy/grimoire/main/install.sh | bash

This script will:

• Check for required dependencies (git, node/bun)
• Use your existing bun or npm if available
• Offer to install bun if neither is found
• Suggest optional dependencies for full functionality

Package Managers

**Bun (recommended)**

bun install -g grimoire

**npm**

npm install -g grimoire

**pnpm**

pnpm add -g grimoire

From Source

git clone https://github.com/aaryareddy/grimoire.git
cd grimoire
bun install
bun run build
bun link

Verify Installation

grimoire --version
grimoire --help

The CLI is available as both `grimoire` and `grim` (short alias).

Requirements

**Required:**

• Node.js 18+ or Bun - JavaScript runtime
• git - Version control

**Optional (for specific features):**

Dependency	Feature	Install
Claude Code	Spawn agents in worktrees (grim wt spawn)	npm install -g @anthropic-ai/claude-code
Beads	Issue tracking integration (grim wt from-issue)	curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
GitHub CLI	Create PRs from worktrees (grim wt pr)	brew install gh or download
SRT	Sandboxed agent execution	npm install -g @anthropic-ai/sandbox-runtime
bubblewrap, socat	SRT on Linux	sudo apt install bubblewrap socat

---

Quick Start

Create your first prompt

grimoire hello-world

This op