Quickstart

Clone galdr

Clone the repo to your home directory. One-time setup per machine.

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

Copy template into your project

Copy the galdr system files into your project root.

# macOS / Linux
cp -r ~/galdr/template_full/. /path/to/your-project/

# Windows (PowerShell)
Copy-Item -Recurse -Force "$HOME\galdr\template_full\*" ".\"

Initialize galdr in your IDE

Open your project in your AI IDE. Run the setup command — the agent will ask your project name, mission, and tech stack.

@g-setup

After setup, run @g-status to confirm everything loaded.

@g-status

Create your first task

Pick something small and concrete — a bug fix, a new endpoint, a UI component. Pass it as an argument.

@g-task-new Fix the broken 404 page styling

Galdr creates .galdr/tasks/task001_fix_404_page_styling.md with acceptance criteria. Review it — edit the criteria if needed.

Implement the task

Run the implementation command. The agent reads the task, implements it, checks each acceptance criterion, and marks the task [🔍].

@g-go-code

Verify in a new session

Open a new chat window (new agent session). Run the review command. This is the adversarial gate — a structurally separate agent checks the implementation.

@g-go-review

If all criteria pass: the task is marked [✅] complete. If something fails: it goes back to pending with a FAIL note, and you repeat from step 5.