FAQ

What is gald3r, in one sentence?

A file-first, AI-assisted task-tracking and coordination framework that gives your AI coding assistant a shared, git-trackable control plane (.gald3r/) for tasks, plans, bugs, and cross-project work — across 35+ platforms.

Do I need a specific AI assistant?

No. gald3r works with Cursor, Claude Code, GitHub Copilot, Codex, Gemini, OpenCode, and 30+ others. See Platform Support for the capability matrix. Even platforms without native hooks or commands get the full file-first experience.

Where does gald3r store its data?

Everything lives under .gald3r/ in your repo as plain markdown — tasks, bugs, plans, constraints, subsystems. It's portable, diffable, and version-controlled alongside your code.

Will gald3r overwrite my work during an upgrade?

No. gald3r upgrade takes a timestamped backup, migrates only framework files, and never touches user data (tasks/, bugs/, TASKS.md, PLAN.md, etc.). Any failure rolls back automatically.

How do I install it?

Open your project in your AI assistant and run @g-setup (Cursor) or /g-setup (Claude Code). See the Quickstart.

What's the difference between @g-go and @g-go-code?

• @g-go-code — implementation only. Marks tasks [🔍] (awaiting verification), never [✅].
• @g-go — full pipeline: implements, then spawns a fresh independent reviewer agent that

verifies the work against acceptance criteria with no access to the implementer's reasoning.

Why does gald3r use a separate reviewer agent?

To avoid self-grading bias. The reviewer sees only the task spec and the resulting code — not the implementer's chain of thought — so verification is genuinely adversarial.

Does gald3r push to git automatically?

It commits freely (with structured, convention-following messages via @g-git-commit) but never pushes without your confirmation.

Is gald3r install agent|throne available?

Not yet for consumers — it's temporarily blocked pending precompiled installers (tracked in T528 and T529). Developers can still build from source. This will be re-enabled when the signed installers ship.

Where can I report bugs or request features?

Open an issue at github.com/Gald3r-Labs/gald3r. Inside a gald3r project, you can also use @g-bug-report and @g-idea-capture.

---

Last updated: 2026-06-20 (gald3r v2.1.0)