🎉 gald3r v5.0.58 is out — gald3r 5.0.58 — choose one recommended download for your computer..See release notes →
Gald3r
Beginner track10 min · Step 1 of 3

Installing gald3r

gald3r is a single signed binary — no npm install, no Python, no git clone, no account required for the CLI itself. This tutorial walks through the full install, per OS, from download to a confirmed working .gald3r/ folder.

Prerequisites

  • →Nothing to install first — download the signed binary for your OS
  • →At least one AI coding tool (Cursor, Claude Code, Codex CLI, or Gemini CLI) — optional, the bare CLI works standalone too
  • →A project you want to add gald3r to (can be empty or existing)
1

Download the signed binary for your OS

Every release attaches signed Windows/Linux/macOS binaries and per-OS installers to a GitHub Release on Gald3r-Labs/gald3r_core.

Windows

Download gald3r-windows-x86_64.msi from the release page and run it. The installer puts both gald3r.exe and gald3rw.exe on your PATH in one step, both Authenticode-signed as Gald3r Labs LLC. Open a new terminal and confirm:

gald3r --version

Prefer no installer? The same release ships gald3r-windows-x86_64.zip with the bare binaries. Later upgrades are a single gald3r install update.

macOS

Download gald3r-macos-arm64.pkg and double-click it. Signed as Gald3r Labs LLC and notarized by Apple — no security prompts.

Linux

curl -LO https://github.com/Gald3r-Labs/gald3r_core/releases/latest/download/gald3r-linux-x86_64.tar.gz
tar xzf gald3r-linux-x86_64.tar.gz
cd gald3r-*-linux-x86_64
./install.sh
gald3r --version
Note: Windows ships two executables: gald3r.exe (console — always type this one) and gald3rw.exe (GUI-subsystem attach, used only by processes like Gald3r Throne that must never flash a console window). Never invoke gald3rw yourself.
2

Confirm the install is healthy

Open a new terminal and check the version, then run an honest health check:

gald3r --version
gald3r doctor

doctor never fabricates a green result — on a fresh install with no project scaffolded yet, most rows report skip rather than fail.

3

Scaffold your project

From inside the project directory you want gald3r-enabled:

cd /path/to/your/project
gald3r setup --dry-run   # preview, writes nothing
gald3r setup             # actually create .gald3r/
4

Optional: add your AI IDE's overlay

gald3r setup only ever scaffolds .gald3r/ — no .claude//.cursor/unless you ask. Write your IDE's command layer with:

gald3r platform install claude   # writes .claude/ into the current directory
gald3r platform install cursor   # writes .cursor/ into the current directory
Note: Once installed, gald3r task add is the same as typing /g-task-add in Claude Code, or @g-task-addin Cursor — same underlying logic, from inside your editor's chat instead of a terminal.
5

Confirm the install

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

.gald3r/
├── PROJECT.md        ← edit this with your mission
├── TASKS.md          ← your task list (starts empty)
├── BUGS.md           ← bug index (starts empty)
├── PLAN.md           ← milestones
├── 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 gald3r setup.

6

Keep gald3r current

gald3r install update    # replace the PATH binary with the latest signed release
gald3r version-check     # find out if a newer gald3r is available -- works offline

Install complete ✓

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