Skip to content

Latest commit

 

History

107 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Gald3r

gald3r — give your AI coding tools one shared brain

Your AI assistants each start from zero, every session, in every tool.
gald3r drops a persistent, file-based brain into your repo — tasks, bugs, plans, and constraints that every AI tool reads and writes.
Plan in one tool. Code in another. Nothing is lost between them.

latest gald3r version engine Windows, macOS, Linux license

Docs · Changelog · All 38 platforms


🎬 COMING SOON — your AI team gets a face. And a stage. And a show.

in the studio going live soon 24/7 broadcast

Stop watching scrolling logs.
gald3r's next act puts your entire AI crew inside a living, walkable 3D world —
characters with names, faces, voices, and desks, performing your project's real work in real time.
Watch them huddle over a bug. Argue in the war room. Celebrate a release by the pool.
Then step in yourself — on screen or in VR — and run the room.

the whole estate at night — cast roster, room-by-room navigation, walk mode, creator studio

And it's bigger than code. The same stage is built for every kind of project gald3r runs
podcasts and newscasts with an anchor desk, music and video productions, episodic shows, skits,
choose-your-own-adventure worlds — describe your set in plain words, drop in reference pictures,
and the creator studio builds the world, the cast, and the show around your project.
Any project type. Any theme. Yours. Broadcast it 24/7.

Built on the gald3r engine below — the shared brain becomes a shared world.
First look is coming to the stream. Watch this space.


v5.0.0 — public beta

The Go rewrite is out now — signed on Windows, macOS, and Linux. The version badge above always shows the newest release; every link below resolves to it.

OS Installer Portable (all binaries)
Windows gald3r-windows-x86_64.msi (signed) gald3r-windows-x86_64.zip
macOS gald3r-macos-arm64.pkg (signed) gald3r-macos-arm64.tar.gz
Linux gald3r-linux-x86_64.tar.gz (with install.sh) gald3r-linux-x86_64.tar.gz

Authenticode-signed on Windows, Developer-ID codesigned + Apple-notarized on macOS, sha256 sidecars on every asset. These links always resolve to the newest release.

Companion apps — optional, installed separately:

App What it is Get it
Throne Desktop control center for gald3r projects (Windows/macOS/Linux) gald3r install throne — fetches the latest signed build from gald3r_throne releases (minisign-verified)
Longship Terminal UI for chat + swarm work, same engine Built on the same engine — public distribution lands in an upcoming beta

Everything — the framework, all 38 platform overlays, the task engine — ships in one binary and provisions from it. This repo is the product's front door; the binary does the rest.


The problem

You use Cursor for one thing and Claude Code for another. Maybe Copilot at work, Codex on a side project, a local model when you're offline. Each one opens with no idea what you decided yesterday, what's already broken, or what you told the last one never to touch.

So you re-explain. Every time. In every tool.

What gald3r does

gald3r puts a .gald3r/ folder in your project — plain markdown files for tasks, bugs, plans, constraints, and cross-project coordination. Every AI coding tool you use reads and writes the same files:

  • Tasks and bugs that live in your repo, in your git history — not in one tool's memory
  • Constraints your AI agents must follow — user-authored, per-project law
  • Plans and PRDs that survive restarts, tool swaps, and team changes
  • A deterministic engine (gald3r) that runs the boring parts with zero LLM calls

No accounts. No server. No database to operate. No Docker.


Quick start

1. Get the binary — from gald3r_core releases:

OS Fastest path
Windows Download gald3r-windows-x86_64.msi, run it, open a new terminal
macOS Download gald3r-macos-arm64.pkg, double-click, follow the prompts
Linux curl -LO .../releases/latest/download/gald3r-linux-x86_64.tar.gz && tar xzf gald3r-linux-x86_64.tar.gz && ./gald3r-*-linux-x86_64/install.sh

Verify with gald3r --version. (Full per-OS instructions, checksums, and source builds: docs.gald3r.ai/install.)

2. Put the brain in your project:

cd /path/to/your/project
gald3r setup                      # creates .gald3r/ and walks you through
gald3r platform install cursor    # or: claude, codex, opencode, copilot, windsurf, ...

3. Open your AI tool and go. /g-setup in Claude Code, @g-setup in Cursor — the brain is live and every AI you point at the repo can see it.

4. Your first five minutes — everything works from any terminal, any tool:

gald3r status                     # where the project stands, at a glance
gald3r task add "Ship the login fix" --origin owner-verbatim \
  --objective "Fix the redirect loop on login and prove it with a test" \
  --why "Users bounce on every failed login" --impacted src/auth
gald3r task list                  # the board, priority-sorted
gald3r doctor                     # health check: config, PATH, platform overlays

Tasks carry their full story by design — who asked, what for, why, and what it touches — so an AI (or a teammate) reading the task three weeks from now doesn't have to re-derive your intent. Bugs work the same way: gald3r bug add.


Keeping gald3r up to date

New releases ship frequently. The update ritual, in order:

gald3r install update                    # fetch + install the newest signed release
gald3r -v                                # confirm the new version took
gald3r platform install cursor --force   # regenerate each AI tool's overlay
gald3r platform install claude --force   #   (--force overwrites the old files;
gald3r platform install codex --force    #    run one line per tool you use)
gald3r upgrade-project                   # migrate .gald3r/ to the new schema
gald3r doctor                            # verify everything landed clean
gald3r task-sync-check -fix              # reconcile any index/file drift

The platform overlays are generated from the binary, so re-running platform install --force after every update keeps your AI tools' commands and skills exactly in sync with the engine version you're running.


Supported Platforms

gald3r installs the same .gald3r/ task board, bug tracker, and CRASH overlay into every platform below — one binary, gald3r platform install <name>, and the files that platform actually reads land in your project. Full capability breakdown: PLATFORM_SUPPORT.md.

  • Aider — also searched as aider-chat, Aider AI
  • Amp — also searched as Amp Code, Sourcegraph Amp
  • AstrBot
  • Augment Code — also searched as Auggie, Auggie CLI
  • Claude Code — also searched as Claude, Anthropic Claude Code
  • Cline
  • Continue.dev — also searched as Continue
  • Cursor — also searched as Cursor IDE
  • Deep Code CLI — also searched as Deep Code, deepcode-cli
  • Devin Desktop — also searched as Windsurf, Cascade IDE
  • GitHub Copilot — also searched as Copilot, GitHub Copilot CLI
  • Google Antigravity — also searched as Antigravity IDE, Antigravity
  • Goose — also searched as Block Goose, Goose AI agent
  • Hermes Agent — also searched as Nous Hermes Agent, Nous Research Hermes
  • JetBrains Junie — also searched as Junie
  • Kilo Code — also searched as KiloCode
  • Kimi Code — also searched as Kimi Code CLI, Moonshot Kimi Code, kimi-cli
  • Kiro — also searched as Kiro IDE, Amazon Kiro
  • Kiro CLI — also searched as Amazon Q Developer CLI, Q Developer CLI
  • Mistral Vibe CLI — also searched as mistral-vibe, Mistral Code
  • OpenAI Codex — also searched as Codex CLI, Codex
  • OpenClaw
  • OpenCode — also searched as sst/opencode
  • OpenHands — also searched as All Hands AI, OpenDevin
  • Pi — also searched as badlogic/pi-mono, Pi coding agent
  • Qoder — also searched as Alibaba Qoder
  • Qwen Code — also searched as Alibaba Qwen Code
  • Replit Agent — also searched as Replit
  • Roo Code — also searched as Roo Cline
  • SubQ Code — also searched as SubQ
  • Tencent CodeBuddy Code — also searched as CodeBuddy
  • TRAE — also searched as ByteDance TRAE, TRAE IDE
  • Void — also searched as Void IDE
  • Warp — also searched as Warp terminal, Warp Oz
  • Xiaomi MiMo-Code — also searched as MiMo-Code, MiMo Code
  • ZCode — also searched as Z.ai ZCode, GLM ZCode
  • Zed — also searched as Zed Editor

Works With

gald3r doesn't just live inside Claude Code and Cursor — it can drive them headlessly for autonomous pipelines, and it talks straight to your model backend of choice, local or cloud:

Backend What it is Docs
Claude Code Anthropic's terminal coding agent — g-go/g-go-go drive it headlessly for autonomous coding Platform guide
Cursor The cursor-agent CLI — same headless autopilot story, one flag away Platform guide
Ollama Local model runtime — gald3r init-providers auto-discovers every model you've pulled Provider docs
LM Studio Local model runtime with a GGUF library and its own local server Provider docs
OpenRouter One API key, every hosted model — openai_compat, no adapter needed Provider docs
Unsloth Studio NEW Built-in unsloth provider id, bearer-token auth, localhost:8888/v1 by default — gald3r's first-supporter, day-one integration Provider docs

Full local + cloud provider setup: Models & Providers.


Autopilot — one loop, any brain

gald3r autopilot loop claims work off your board, implements it, reviews it, and repeats — unattended. Every role (coordinator / implementer / reviewer) takes an explicit provider and model; nothing is silently defaulted. --budget caps implementation starts, --lanes caps parallel implementers.

Cursor (all three roles on Cursor's hosted Grok):

gald3r autopilot loop --budget 8 --lanes 3 --coordinator-provider cursor-agent --coordinator-model cursor-grok-4.6-high-fast --implementer-provider cursor-agent --implementer-model cursor-grok-4.6-high-fast --reviewer-provider cursor-agent --reviewer-model cursor-grok-4.6-high-fast

Cursor slug caveat: cursor-agent doesn't validate model names — an unrecognized slug silently runs (and bills) against a fallback model. Probe a new slug first: cursor-agent -p "reply OK" --model <slug>.

Claude Code (all three roles on Anthropic):

gald3r autopilot loop --budget 8 --lanes 3 --coordinator-provider claude --coordinator-model claude-sonnet-5 --implementer-provider claude --implementer-model claude-sonnet-5 --reviewer-provider claude --reviewer-model claude-sonnet-5

OpenRouter — Ox Alpha workers (1M-context stealth model, free tier; the coordinator role currently requires a CLI agent — expansion to every provider is on the roadmap):

gald3r autopilot loop --budget 8 --lanes 3 --coordinator-provider claude --coordinator-model claude-sonnet-5 --implementer-provider openrouter --implementer-model stealth/ox-alpha --reviewer-provider openrouter --reviewer-model stealth/ox-alpha

Ollama — Qwen 3.8 27B on your own GPU (4-bit fits a 24 GB card; workers cost $0):

gald3r autopilot loop --budget 8 --lanes 3 --coordinator-provider claude --coordinator-model claude-sonnet-5 --implementer-provider ollama --implementer-model qwen3.8:27b --reviewer-provider ollama --reviewer-model qwen3.8:27b

Ollama — Ornith 1.5 9B on your own GPU (small, fast, fine for light lanes):

gald3r autopilot loop --budget 8 --lanes 3 --coordinator-provider claude --coordinator-model claude-sonnet-5 --implementer-provider ollama --implementer-model ornith:9b --reviewer-provider ollama --reviewer-model ornith:9b

Unsloth Studio — Qwen 3.8 27B implementing, DeepSeek-V4-Flash reviewing (Unsloth's Dynamic 3.0 GGUFs and DeepSeek-V4 — match the model ids to what your Unsloth Studio instance lists; UNSLOTH_API_KEY required):

gald3r autopilot loop --budget 8 --lanes 3 --coordinator-provider claude --coordinator-model claude-sonnet-5 --implementer-provider unsloth --implementer-model Qwen3.8-27B-GGUF --reviewer-provider unsloth --reviewer-model DeepSeek-V4-Flash-GGUF

Mix freely: a hosted frontier coordinator with local $0 workers is the cost-efficient default. Register your endpoints once in providers.yaml (gald3r init-providers, then gald3r providers add) and every example above routes through it.


The gald3r system — who does what

One product family, five pieces. ● owns it · ◐ involved in it.

What you see In plain terms gald3r_core (engine) gald3r_throne (desktop) world_tree (cloud) Framework (CRASH) Longship (agent) Docs
Task, bug & plan tracking A file-based brain in your repo every AI reads and writes ● owns the verbs + database ◐ displays it ◐ syncs it ◐ defines the format docs
Rules & constraint enforcement Always-on behavioral guardrails + your own per-project law ● owns the checker + constraint verbs ● ships the rule packs docs
38 IDE/platform integrations Cursor, Claude Code, Codex, Copilot & 34 more, from one binary ● generates every overlay ● the content itself matrix
Autonomous pipelines g-go / g-go-go — claim, implement, verify, review, unattended ● owns the orchestration ◐ defines the playbooks ◐ execution plane docs
Desktop workbench A native GUI over the same brain and engine ● owns it throne
Cross-project coordination Projects ask/order/sync with each other (WPAC) ◐ the client ◐ the registry ● the protocol docs
Live coordination backbone (Valkyrie) Agents message you and each other mid-run; the local brain syncs to the cloud ◐ the gald3r valk connector ◐ its inbox ● the sync target ◐ the ledger format docs
Cloud sync & identity Multi-device sync and sign-in for teams gald3r valk client ● owns it docs
Memory & knowledge vault Scoped cross-session memory (project/user/client), stash & reload for long runs, Obsidian-compatible vault ● owns it ◐ sync (roadmap) docs
Personality system A startup team of Norse gods voices your agents — Thor on performance, Sindri on craft, Loki on creative breakage ◐ activation layer ◐ shows it ● the persona packs docs
Skill packs Curated capability bundles per project type — install a pack, get its skills locked to it ● owns skill-pack / skills-lock ● the bundles docs
Third-party plugins Install plugins from any git repo; enable/disable per project ● owns gald3r plugin ◐ SKILL.md format docs
Themed reports Status, review, and backlog reports rendered in your chosen theme ● the render engine ◐ displays it ● theme definitions docs
Workspace-Control One control project governs many repos, with guarded member boundaries ● owns it ◐ the manifest format docs
Experiments framework Hypotheses with measurable gates and failure autopsies, tracked like code ● owns it ◐ the experiment format docs
Generated CRASH reference The full user-facing catalog of every command, skill, rule, agent, and hook shipped ● generates it from source ● the corpus docs
Multi-format output The same reports as markdown, HTML, JSON, or TOON — for humans and agents ● owns it docs
QA, review & security gates Deterministic validation that blocks bad state before it lands ● owns the gates ◐ the hooks that call them docs
Release & code signing One tag → signed binaries for all three OSes ● owns the pipeline docs
MCP server Other AI tools query your gald3r brain as MCP tools ● owns it docs

gald3r_core, gald3r_throne, world_tree, and gald3r_longship ship as compiled binaries (the first two public, the rest private) — this repo carries the framework they all serve, plus everything below.

In the forge — honestly unfinished

Marketable, on the way, and labeled as such:

In the forge What it becomes Where it lives today
Marketplace A curated, signed plugin registry on world_tree Design (blocked on the cloud registry); git-installed plugins work today
Custom themes A visual editor for your own report themes Theme definitions ship; editor in progress
Suite installer One manifest install: core + longship + throne together Design complete; implementation next
Scoped memory sync Your memory follows you across machines Local memory shipped; cloud sync on the roadmap

What's in this repo

This repo is gald3r's front door — a landing page, not an install dependency:

Path What it is
README.md This page
PLATFORM_SUPPORT.md The full 38-platform support matrix — with the honest gaps marked
platforms/ Per-platform reference docs — how each tool's project structure and extension surfaces actually work
CHANGELOG.md Release history
LICENSE, NOTICE License (FSL-1.1-Apache-2.0)
VERSION Current version marker

Everything that used to live here as file trees — the per-platform skill/command/rule overlays and the project template — now ships inside the binary and is generated by it: gald3r platform install <platform> writes the exact overlay for your AI tool, always current with your binary version, on all 38 supported platforms. One binary, every tool, no template copies to drift.


License

FSL-1.1-Apache-2.0 — free to use; converts to Apache 2.0 on the same schedule. See NOTICE for attribution.

About

AI dev framework: 22 agents, 100 core skills + 142 addon skill packs, 149 commands. Runs on 21 AI tools: Cursor, Claude Code, Copilot, Windsurf, Cline, Aider, Roo, Kiro, OpenHands, Gemini, Codex, Goose, Warp & more. File-based memory persists across sessions.

Topics

Resources

Stars

24 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages