GDH

GDH helps AI coding agents work inside Godot projects without guessing the project shape, authoring checks, runtime guidance, or validation evidence.

Quick Start

Run this from the Godot project or repo you want GDH to manage:

npx -y @skillcap/gdh@latest setup

Then open your agent in that project and run:

/gdh-onboard

GDH writes the project guidance, agent skill surfaces, MCP config, and local state that supported agents use for future work. In monorepos, full guidance and skills stay in the selected Godot project directory while only thin root routing/config surfaces are installed for agents launched from the repo root. Setup records the resolved GDH version in the target project so later updates can migrate that project deliberately.

Requirements

• Node.js 24 or newer.
• A local Godot project, currently focused on Godot 4.4 through 4.6.
• A supported AI coding agent: Codex or Claude.
• Optional: GDH_GODOT_EDITOR_BIN for Godot import refresh and local editor-backed checks.
• Optional: Docker when a project-owned run workflow uses containers.

What It Does

• Finds Godot project roots and writes .gdh/project.yaml, .gdh/runtime-knowledge/run-game.md, plus .gdh-state/ derived state.
• Installs agent commands and skills such as /gdh-status, /gdh-prepare, /gdh-run-game, /gdh-migrate, and /gdh-update.
• Exposes MCP tools for project status, authoring checks, docs lookup, and bounded bridge/editor inspection.
• Teaches agents to run the game through project-owned commands and keep run knowledge fresh instead of forcing launch behavior into a GDH wrapper.
• Keeps generated target-project files inside the managed project, not in GDH's own implementation repo.

Common Commands

Managed targets pin GDH in .gdh/project.yaml; use that pin instead of a global install. In examples below, replace <pinned> with the target's gdh_version.

npx -y @skillcap/gdh@latest setup
npx -y @skillcap/gdh@<pinned> status
npx -y @skillcap/gdh@<pinned> target prepare --dry-run
npx -y @skillcap/gdh@<pinned> authoring check --mode final
npx -y @skillcap/gdh@<pinned> authoring check --mode post-edit --changed res://scripts/player.gd --format compact
npx -y @skillcap/gdh@latest self-update --dry-run --target .

More Docs

• Install and update
• Advanced CLI usage
• Editor Bridge
• Runtime support matrix
• Runtime release readiness
• All docs

License

MIT