🎉 Gald3r v3.0.0 is out — Agent v0.2.0 + Throne v0.2.0 binaries downloadable now. See release notes →
Gald3r — Song magic for your codebase
v3.0.0 — Latest Release

Song magic for your codebase.

Persistent memory, multi-repo orchestration, and adversarial quality gates for AI coding agents — across every major IDE. Without changing how you code.

v3.0.0 · 38 AI tools · FSL-1.1-Apache · file-first, optional engine

git clone https://github.com/Gald3r-Labs/gald3r.git
13
Agents
111
Skills
179
Commands
38
Platforms

Works with your IDE

CursorClaude CodeGeminiCodexOpenCodeGitHub Copilot

The Problem

Your AI agents forget everything the moment you close the chat.

Session 1: You explain your architecture, your constraints, why you chose Postgres over Mongo.
Session 12: The agent uses SQLite. Because it doesn't remember session 1.

You're running 4 repos — api, web, mobile, shared-lib. When something changes in shared-lib, every downstream repo needs to know. There's no mechanism for that.

You ask the same agent that wrote the code to verify it. It passes everything — of course it does. The bugs it introduced are invisible to it.

Gald3r is the infrastructure layer that fixes all three. It wraps around your AI IDEs and gives agents durable memory, cross-repo coordination, and adversarial quality enforcement.

What Gald3r Gives Your Agents

Four pillars of AI-assisted development

Persistent Memory

Architectural decisions, learned conventions, and session summaries that survive across conversations, machines, and IDE restarts. Your AI never forgets session 1.

Multi-Repo Orchestration

Declare parent/child/sibling relationships between repos. Broadcast tasks that cascade down your project hierarchy. One unified INBOX for cross-project coordination.

Adversarial Quality Gates

The agent that implements code is structurally prevented from marking it done. A separate session runs verification. Stuck tasks auto-escalate with full audit trails.

38 Tools, 6 at Full Parity

38 AI coding tools supported — including newer entrants like Zed, Kimi Code, and Xiaomi's MiMo-Code. Six — Cursor, Claude Code, Gemini, Codex, OpenCode, and GitHub Copilot — share the same agents, skills, memory, and task state, so you can switch between them mid-task and pick up exactly where you left off.

The gald3r family

Three products. One ecosystem.

The file-first framework is free and ships today. The runtime and desktop app are downloadable now — paid coordination features are waitlist-only.

✓ Shipping now

gald3r

The free, file-first framework — 13 agents, 111 skills, 179 commands, rules, hooks, and a Python engine. Plain markdown in .gald3r/, works in 38 IDEs.

Get started free →
📦 v0.2.0

gald3r_agent

The Python runtime that powers the gald3r CLI. Tool loop, inference backends, tracing/eval, MCP routing. Ships as a signed packaged binary — no source build required.

Download v0.2.0 →
📦 v0.2.0

gald3r_throne

Hlidskjalf — the desktop workspace control plane. A Tauri 2 app with live task dashboards, dry-run→apply with backup/rollback, personality packs, animated avatars, and a Chrono scheduler.

Download v0.2.0 →

New in v2.0.0

The Engine — a deterministic core, no LLM required

Gald3r v2.0.0 shipped a bundled Python engine that handles all the mechanical parts of task management without touching your AI or your network. No Docker, no servers, no API keys until you want the optional self-hosted MCP backend.

  • gald3r initScaffold or upgrade a project in one command. Idempotent — safe to re-run.
  • gald3r task newCreate structured task files with acceptance criteria, type, and priority.
  • gald3r doctorRead-only health check — 11 gates, suitable for CI pipelines.
  • gald3r upgradePull the latest release; takes a timestamped backup first; auto-rolls back on failure.
  • gald3r vault ingestIndex local files into the knowledge vault without Docker.

$ gald3r init

✓ .gald3r/ structure created

✓ TASKS.md, BUGS.md, PLAN.md ready

✓ 13 agents, 111 skills deployed

$ gald3r doctor

Running 11 health checks...

✓ All checks passed

$ gald3r upgrade

Backup → .gald3r/backups/20260620_133000

Applying v3.0.0 patches...

✓ Upgrade complete. Tasks and bugs untouched.

New in v2.0.1

Upgrade without fear

gald3r upgrade is designed so the worst-case outcome is a 30-second rollback. Your tasks, bugs, plans, and vault are never touched.

1

Timestamped backup

Before touching a single file, the engine snapshots your .gald3r/ directory to .gald3r/backups/YYYYMMDD_HHMMSS/.

2

Selective patch

Only framework files are updated — agents, skills, commands, hooks. TASKS.md, BUGS.md, PLAN.md, and vault notes are untouched.

3

Auto rollback on failure

If any patch step fails, the engine automatically restores the backup. No partial upgrades, no corrupt state.

How far we've come

18 releases. 6 months. Still accelerating.

v1.0.0Jan 1Initial release
v1.1.0Feb 14PCAC multi-project
v1.2.0Mar 28OpenCode + hooks
v1.2.1Apr 15File transfer
v1.4.0Apr 21Copilot + swarm
v1.5.0May 10Platform framework
v1.5.1May 18Plugin author guide
v1.5.2May 21HTML/JSON/TOON output
v1.6.0May 25Semantic versioning
v1.7.0May 2834 AI tools
v1.8.0May 3035 AI tools
v1.9.0May 31plugins/ + verify
v2.0.0Jun 4🔥 The Engine
v2.0.1Jun 19Self-update stack
v2.1.0Jun 20CLI home + hooks
v3.0.0Jul 5Agent + Throne binaries
Current Major Minor Patch

Changelog

Actively maintained and evolving

Latest releases across the gald3r family — the framework, the Agent CLI, and the Throne desktop app. Scroll each column to see full version history.

Framework

v3.0.0
major2026-07-05
  • IP-protected distribution: installed repos now ship the compiled `gald3r` engine instead of readable Python source, with a fail-closed leak-lint gate that blocks any build or publish that would leak engine source.
  • Skill & hook IP absorbed into stable engine verbs — worktree, push-gate, housekeeping, WPAC/workspace, auto-triage, policy, and the g-go-go autopilot loop now run from the binary (`gald3r worktree|push-gate|housekeep|workspace|autopilot|bug triage|policy`); the old bundled helper scripts no longer ship.
  • New platform support added: Zed (Agent Client Protocol host), Pi (badlogic/pi-mono), and ZCode (Z.ai / GLM) — broadening gald3r's AI-tool coverage.
  • Cross-platform install fix: fresh Linux (python3-only) machines no longer need a `python` symlink — hook interpreters are stamped to python3 on POSIX at install time.
  • Encoding integrity: eliminated double-encoded UTF-8 (mojibake) across shipped templates and added a fail-closed mojibake guard to the build/publish gate.
  • PowerShell purge complete — every `.ps1` script ported to Python (core `.ps1` count now 0), dropping the pwsh / ExecutionPolicy dependency.
  • Logging & vault chains repaired: chat log, session trace, CRASH record, graph refresh, and the vault reindex + raw-inbox watcher now actually fire on session lifecycle events; vault `_index.yaml` regenerated UTF-8, no BOM.
  • Coordination plumbing landed (territory leasing, policy-as-code, a per-project coordination on/off switch) — but the hosted agent-to-agent coordination backend is still in development, file-transport-only today, and not yet enabled.
  • Released alongside: gald3r_agent v0.2.0 (signed, compiled CLI binary) and gald3r_throne v0.2.0 (Tauri 2 desktop app), both downloadable from GitHub Releases.

Release History

v2.1.0
minor2026-06-20
  • One-command install: `gald3r install agent|throne|all` (Windows, macOS, Linux)
  • Centralized install home (settings, logs, vault) + global `gald3r` command from any directory; USB-portable mode
  • Safe self-update: `gald3r upgrade` with timestamped backup + automatic rollback; tasks/bugs/plans never touched
  • `gald3r init` / `gald3r update` — idempotent project scaffolding & upgrade
  • Canonical hook event set (6 events, one shared Python core) wired across 9/9 hook-capable platforms
  • Build hygiene: generated repos no longer ship .venv / __pycache__ / .pytest_cache
v2.0.1
patch2026-06-19
  • Self-update stack: `gald3r version-check` + `gald3r upgrade` (offline-first, rollback-safe)
  • gald3r_throne in-app update — detect & apply updates inside the app, in compiled Rust (no Python)
  • Throne developer-experience suite
v2.0.0
major2026-06-04
  • The Engine Release — bundled file-first Python engine (.gald3r_sys/engine/): deterministic, no LLM, no network, no Docker
  • `gald3r` CLI + MCP server (~37 tools): `gald3r task new`, `gald3r bug new`, `gald3r vault ingest`, and more
  • `gald3r doctor` — read-only health check + CI gate
  • Five maintenance scripts absorbed into engine verbs; each keeps a no-engine .ps1 fallback
  • Judgment/prompt layer: 15 reasoning assets served by the engine
v1.9.0
minor2026-05-31
  • Plugin system foundation: @g-plugin-install (ADR-015), manifest schema + validator, security-first installer
  • gald3r public repo restructured — 34 platform dirs moved into platforms/ subfolder
  • post_push_verify.ps1 — 11-check post-release gate (incl. secrets scan)
  • Removed redundant @g-kamikaze / @g-juggernaut aliases (use @g-mission)
v1.8.0
minor2026-05-30
  • 35 AI tool support finalized — mimo-code (Xiaomi MiMo-Code, OpenCode fork) added as supported platform
  • Platform CRASH capability matrix published across all 35 tools
  • Full platform spec HTML generation pipeline
v1.7.0
minor2026-05-28
  • 34 AI coding tools — 11 new platforms (Kimi Code, TRAE, Qoder, Amp, Continue, Void, and more), all QA-passing
  • g-go-go coding swarm fix — Phase 1 now runs N parallel coders via g-go-code-swarm
  • Context-aware throttle ON by default — reduces parallelism under context pressure instead of stopping
  • Platform templates restructured to repo root as drop-in folders (T1522)
v1.6.0
minor2026-05-25
  • Schema enforcement — every .gald3r/ file validated against 15 versioned schemas; sub-second session-start drift probe
  • Semantic versioning + release management — g-skl-ship / @g-ship promote CHANGELOG to tagged releases
  • Dedicated bug-fix pipeline (@g-go-bugs)
  • WPAC v1.6 autonomous-child workspace model; encoding normalization
v1.5.2
patch2026-05-21
  • HTML / JSON / TOON output modes + 3-theme system (--html / --json / --toon)
  • Memory compression + project vocabulary management
  • Skill review (@g-skill-review) + opt-in auto-skill-generation after PASS verdicts
v1.5.1
patch2026-05-18
  • Plugin author guide (docs/PLUGINS.md) + skill-pack distribution and naming guidelines
v1.5.0
minor2026-05-10
  • Platform Framework Architecture (.gald3r_sys/) — canonical framework tree
  • g-skl-security-scan — two-phase SAST scanner across 12 vulnerability categories
  • g-skl-context-builder + g-skl-delegate workflow skills
  • Recon & research suite expansion
v1.4.0
minor2026-04-21
  • GitHub Copilot support — 6th IDE, 89 commands deployed to .copilot/
  • Recon suite: g-skl-recon-repo/url/docs/yt/file replaces ingest/harvest/reverse-spec
  • Research workflow: g-skl-res-review → res-deep → res-apply (3-step pipeline)
  • Swarm commands: @g-go-swarm, @g-go-code-swarm, @g-go-review-swarm
  • Release management: g-skl-release + .gald3r/releases/ + RELEASES.md
  • g-skl-medic: surgical repair for individual .gald3r/ files
  • Codex + Copilot CLI skills added
v1.2.1
patch2026-04-15
  • Added g-skl-pcac-send-to for topology-aware file transfer
  • g-skl-medkit now handles v1.0→v1.1→v1.2 migration in one pass
  • Fixed TASKS.md sync drift in multi-agent sessions
  • Added g-skl-cli-gemini checkpoint flag documentation
v1.2.0
minor2026-03-28
  • Feature pipeline: staging→specced→committed→shipped lifecycle
  • g-skl-reverse-spec: 5-pass deep repo analysis (now g-skl-recon-repo in v1.4)
  • OpenCode IDE support added (5th IDE target)
  • 12 pre-commit/push hooks including PCAC inbox check
v1.1.0
minor2026-02-14
  • PCAC multi-project coordination system (10 skills)
  • Parent/child/sibling topology with bidirectional linking
  • Task broadcast cascade with configurable depth (1-3)
  • INBOX.md cross-project message routing
v1.0.0
major2026-01-01
  • Initial release — 9 agents, 47 skills, 76 commands
  • 5-IDE parity: Cursor, Claude Code, Gemini, Codex
  • Adversarial two-phase code review gate
  • File-first architecture — zero external dependencies

FAQ

Questions developers ask

What is gald3r?
Gald3r is an AI-native task management framework that wraps around your AI coding IDE. It gives AI agents persistent memory, multi-repo orchestration, and adversarial quality gates — so they remember your architecture across sessions, coordinate changes across repositories, and cannot sign off on their own work.
How do I install gald3r?
Clone the repository and copy the template into your project: git clone https://github.com/Gald3r-Labs/gald3r.git. Gald3r is file-first — no servers or subscriptions are required for the free framework. The Quickstart walks through your first task in under 10 minutes.
Which IDEs does gald3r support?
38 AI coding tools are supported. Six have full parity — Cursor, Claude Code, Gemini CLI, OpenAI Codex, OpenCode, and GitHub Copilot — sharing identical agents, skills, commands, and task state, so you can switch between them mid-task and pick up exactly where you left off.
Is gald3r free?
Yes. The complete gald3r framework — all agents, skills, commands, rules, hooks, the vault, and multi-project coordination — is free under the FSL-1.1-Apache license (Functional Source License, which converts to Apache-2.0 after two years). There are no tiers. An optional self-hosted Docker backend adds MCP memory/search tools and is also free.

ᚷᚨᛚᛞᚱ

Ready to forge your workflow?

Gald3r public releases use the FSL-1.1-Apache license posture. Install it in any project in minutes — no external services, no subscriptions, no magic until you copy the files.