🎉 gald3r v5.0.58 is out — gald3r 5.0.58 — choose one recommended download for your computer..See release notes →
Gald3r

Get Started

Getting Started with Gald3r

gald3r is a single compiled binary — no Python, no Docker, no git clone, and no template to copy. Download the signed release for your OS, run gald3r setup inside your project, and you have a working task/bug tracker and AI agent runtime in minutes.

⏱ 5–10 minutes📦 One signed binary — no Python, no Docker🖥 Works on macOS, Linux, Windows

Install

Every release attaches signed Windows/Linux/macOS binaries and per-OS installers to a GitHub Release on Gald3r-Labs/gald3r_core — the same place gald3r install update pulls from. Want every file in one place, including Throne and gald3r_ide? The download page lists them all.

1

Windows

Download gald3r-windows-x86_64.msi (direct link, always the newest build), double-click it, and let the installer finish — it installs both gald3r.exe and gald3rw.exe and puts them on your PATH. Both are Authenticode-signed as Gald3r Labs LLCvia Azure Trusted Signing, so SmartScreen shows the real publisher — not "Unknown publisher." Then open a new terminal and confirm:

powershell
gald3r --version

Prefer no installer? The same release also ships gald3r-windows-x86_64.zip with the bare binaries. Upgrading later is one command: gald3r install update.

Two executables ship on Windows. gald3r.exe (console subsystem) is the one you always type in a terminal or script — it prints and returns a real exit code, even from a console-less PowerShell host. gald3rw.exe (GUI-subsystem attach) exists only for spawns from a process that must never flash a console window, like Gald3r Throne. Never invoke gald3rw yourself.
2

macOS

Download gald3r-macos-arm64.pkg (Apple silicon) or gald3r-macos-x86_64.pkg (Intel) and double-click it to install to /usr/local/bin/gald3r.

Signed as Gald3r Labs LLC and notarized by Apple, with the notarization ticket stapled on — it installs clean with no security prompts, online or offline. Open a new terminal and confirm with gald3r --version.

3

Linux

bash
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

install.shverifies the bundled checksum before installing and refuses (loudly) if it doesn't match — to ~/.local/bin, or /usr/local/bin if run with sudo.

First run

Every command below is verbatim from the quickstart — real output from a fresh scratch project, nothing invented.

4

Confirm the install is healthy

bash
gald3r doctor

An honest health check that never fabricates a green result — it checks your identity file, any installed IDE overlay, and path resolution in one pass.

5

Scaffold a project

From inside the project directory you want gald3r-enabled:

bash
gald3r setup --dry-run   # see what would be created, writes nothing
gald3r setup             # actually create .gald3r/
6

A zero-configuration smoke test

No network call, no API key required — confirms the agent-run plumbing works before you touch any provider configuration:

bash
gald3r run "hello gald3r" --backend dev-echo
7

Track real work

bash
gald3r task add "Write the quickstart doc" -d "Draft it" --type docs --priority medium
gald3r task list

gald3r task next shows the single next task to work; gald3r task update T1 --status in-progress claims it.

8

Optional: a real agent run with a provider

bash
gald3r init-providers                # write providers.yaml (defaults to local Ollama)
gald3r run "explain what this project does"

The starter config defaults to a local Ollama endpoint — no cloud account or API key required if you already have Ollama running. Edit the generated providers.yaml to point at OpenAI, Anthropic, or any other provider instead.

Inside your IDE

gald3r platform install <name>writes that platform's overlay into your project — the CRASH files your IDE actually reads. Every verb above then becomes an in-IDE slash command dispatching to the same underlying logic.

bash
gald3r platform install claude       # writes .claude/ into the current directory
gald3r platform install cursor       # writes .cursor/ into the current directory

gald3r task add becomes /g-task-add in Claude Code, or @g-task-add in Cursor — same task/bug board, same agents, whichever IDE you switch to mid-task.

Keeping gald3r current

bash
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

What's Next

Gald3r Throne →

The local-first desktop control plane — boards, workspace graph, and the IDE.

Pricing →

What's free, what's seat-based, and what world_tree coordination adds.

Create an account →

Sign in for team/multi-device features, gfix, and world_tree coordination.

Tutorials →

Structured learning paths from "what is this?" to advanced multi-project setups.