Skip to content

Repository files navigation

gdharness

CI Scorecard OpenSSF Best Practices OpenSSF Baseline SLSA Build 3 SBOM Signed releases npm Release MCP server Made for Godot 4.7+ Node Bun Licence

Drive a Godot 4 project from an agent: the editor that is open, the game that is running, and the project on disk.

Hand this to your agent:

Install gdharness into this project by following
https://aureliolo.github.io/gdharness/agent.md, then tell me what it asked you to
recommend back to me.

Or do it yourself, and pick your harness: aureliolo.github.io/gdharness

What it is for

An agent cannot see a running game. This makes one answerable: where a control is, what a property reads, what the console printed, what broke and on which line.

runtime_inspect { "op": "rect", "nodePath": "/root/Hall/Ledger/BuyButton" }

{ "canvas": { "position": { "x": 812, "y": 418 }, "size": { "x": 180, "y": 34 } },
  "visible": true }

At a glance

Needs Godot 4.7 or newer, Node 22 or newer. Runs under Bun 1.4 too.
Surface 30 tools named domain_verb, and 4 godot:// resources
Reaches The editor that is open, a game it is playing, and the project on disk
Harnesses 35, written inside the project wherever the harness has a project config
Skill Written to .agents/skills, which every major harness reads
Install npm, or a Sigstore-signed archive with an SBOM, SLSA Build Level 3
Proven Every tool driven against a pinned Godot in CI, on three platforms

Documentation

aureliolo.github.io/gdharness: installing it, how the parts connect, and every tool, op and argument.

SECURITY.md is how to report something. CONTRIBUTING.md is what a change has to clear.

Project

Fork of GoPeak v2.3.9, September 2026, MIT: the original MCP server godot-mcp by Solomon Elias, GoPeak by HaD0Yun, and completely reworked since to be hardened, condensed and more streamlined.

Not affiliated with the Godot Foundation.

About

A harness for driving a Godot 4 project from an agent: editor addons, a runtime bridge into the running game, an MCP server in front of them, and a CLI that installs and diagnoses the Godot side.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages