Beginner track10 min · Step 1 of 3

Installing galdr

Galdr is a folder you copy into your project. No npm install, no CLI tool to maintain, no account required. This tutorial walks through the full install — from clone to confirmed working setup.

Prerequisites

→Git installed and configured
→At least one AI coding tool (Cursor, Claude Code, Codex CLI, or Gemini CLI)
→A project you want to add galdr to (can be empty or existing)

Clone the galdr repository

First, clone galdr somewhere on your machine. You'll copy files from it into your projects.

git clone https://github.com/wrm3/galdr.git ~/galdr

You only need to do this once. You can reuse this clone to install galdr in multiple projects.

Identify the install type

Galdr supports two install modes depending on how you work:

File copy (recommended for most)

Copy .galdr/, .claude/, .cursor/ into your project. Full ownership, no symlinks.

Symlink (for galdr developers)

Symlink the template folders. Changes to the galdr source propagate automatically.

Note: This tutorial uses the file copy approach. If you're contributing to galdr itself, the symlink approach keeps your clone in sync.

Copy the galdr files into your project

Navigate into your project directory and copy the three folders:

cd /path/to/your/project

# Copy the core galdr framework files
cp -r ~/galdr/template_full/.galdr ./.galdr
cp -r ~/galdr/template_full/.claude ./.claude
cp -r ~/galdr/template_full/.cursor ./.cursor

On Windows (PowerShell):

cd C:\path\to\your\project

Copy-Item -Recurse "$env:USERPROFILE\galdr\template_full\.galdr" ".galdr"
Copy-Item -Recurse "$env:USERPROFILE\galdr\template_full\.claude" ".claude"
Copy-Item -Recurse "$env:USERPROFILE\galdr\template_full\.cursor" ".cursor"

Run galdr setup

Open your AI tool in this project directory and run:

@g-setup

The setup skill will initialize your .galdr/ folder: creating PROJECT.md, TASKS.md, BUGS.md, PLAN.md, DECISIONS.md, and CONSTRAINTS.md with sensible defaults for your project.

Note: If your AI tool doesn't recognize @g-setup, make sure the .cursor/rules/ or .claude/commands/ folders were copied correctly in step 3.

Confirm the install

After setup completes, you should see these files in your project:

.galdr/
├── PROJECT.md        ← edit this with your mission
├── TASKS.md          ← your task list (starts empty)
├── BUGS.md           ← bug index (starts empty)
├── PLAN.md           ← milestones
├── DECISIONS.md      ← audit trail
├── CONSTRAINTS.md    ← hard rules for agents
├── tasks/            ← individual task files go here
└── bugs/             ← individual bug files go here

If any of these are missing, rerun @g-setup or check that the copy in step 3 completed without errors.

(Optional) Add to .gitignore exclusions

Galdr files should commit with your project. The only exception is if you have local overrides or secrets in your vault. By default, commit everything in .galdr/.

If you use the Valhalla MCP server, add its local config to .gitignore:

echo ".galdr/.env.local" >> .gitignore

Install complete ✓

Galdr is installed. The next step is to fill in PROJECT.md and create your first task.