The engine under
the magic.
gald3r_agent is the Python harness that powers every gald3r CLI operation —init,install,upgrade,doctor — and exposes ~37 MCP tools for IDE integration. Ships as an IP-protected packaged binary.
The CLI
One command. Nine verbs.
Every operation you need, from scaffolding to staying current.
gald3r initScaffold a new .gald3r/ project. Idempotent — safe to re-run on existing projects.gald3r install agent|throne|allBuild and install the Agent runtime, Throne desktop app, or both. Windows, macOS, Linux.gald3r upgradePull the latest release. Takes a timestamped backup first. Auto-rolls back on failure. Tasks/bugs/plans never touched.gald3r version-checkOffline-first check for available updates. Returns current vs. latest with a changelog preview.gald3r doctorRead-only 11-check health gate. Safe for CI pipelines. Returns pass/fail per check.gald3r task newCreate a structured task file with acceptance criteria, type, and priority.gald3r bug newLog a bug with severity, kind, and file reference.gald3r vault ingestIndex local files into the knowledge vault without Docker.gald3r homePrint or open the centralized install home (settings, logs, vault). USB-portable mode supported.Capabilities
What the Agent gives you
One CLI, every OS
A single `gald3r` command works across Windows, macOS, and Linux. Install once, stay current, scaffold any project — from the shell or from inside Throne.
Deterministic engine
No LLM, no network calls, no Docker required for the core CLI. Every operation is deterministic and auditable. The engine runs the mechanical parts; your AI handles the creative parts.
IP-protected binary
Ships as a packaged binary — no source code required on the target machine. Right for teams that need predictable installs and a clean IP boundary.
Safe self-update
`gald3r upgrade` takes a timestamped backup before touching any file. If anything fails, it auto-restores. Your tasks, bugs, plans, and vault are structurally excluded from the update path.
MCP server (~37 tools)
The Agent exposes ~37 MCP tools for IDE context-window use: task/bug/vault operations, memory search, project health, and more. Wire it in once; all 35 supported IDEs benefit.
Inference & eval layer
Tool loop, multiple inference backends, tracing/eval, and MCP-oriented routing — the plumbing that makes @g-go, @g-go-code, and @g-go-review work at scale.
Installer coming soon — join the list
The gald3r CLI works from source for developers today. The precompiled, IP-protected binary installer is gated on T529. Sign up to be notified when it ships.
No precompiled installer exists yet. Do not attempt to "Download for Windows/Mac" — it will 404. The framework (free, available now) does not require the Agent binary.