cli-anything-godot

Agent-friendly CLI wrapper for the Godot 4.x game engine. Drives scene files, runs GDScript headlessly, exports projects, inspects the engine API — all from one cli-anything-godot binary that LLMs and humans can call.

Built on top of the HKUDS/CLI-Anything harness pattern. Works on macOS, Linux, and Windows.

One-line install

git clone https://github.com/lxistired/cli-anything-godot.git
cd cli-anything-godot
pip install -e .

Then install Godot 4.6+ and make sure godot is on PATH:

• macOS: brew install --cask godot
• Windows: winget install GodotEngine.GodotEngine
• Linux: download AppImage / tar.xz, add to PATH

Verify:

cli-anything-godot engine info

Use with Claude Code / Claude Agent SDK

Copy cli_anything/godot/skills/SKILL.md to your Claude skills directory so the agent auto-discovers it:

• macOS / Linux: ~/.claude/skills/cli-anything-godot/SKILL.md
• Windows: %USERPROFILE%\.claude\skills\cli-anything-godot\SKILL.md

Any Claude session in a Godot project will then use the CLI instead of poking at .tscn/.gd files by hand.

What you can do from the CLI

# Project scaffolding
cli-anything-godot project new -o mygame --name "My Game"

# Edit scenes (no editor UI required)
cli-anything-godot scene new -o mygame/main.tscn --root-name Main --root-type Node3D
cli-anything-godot scene add-node mygame/main.tscn --name Player --type CharacterBody3D --parent .
cli-anything-godot --json scene info mygame/main.tscn

# Run GDScript headlessly
cli-anything-godot --project mygame script inline -c 'print(ClassDB.class_exists("CesiumGeoreference"))'
cli-anything-godot --project mygame script run path/to/script.gd

# Dump the engine API
cli-anything-godot docs dump-api /tmp/api.json

# Export a game
cli-anything-godot --project mygame export list-presets
cli-anything-godot --project mygame export run --preset "Linux/X11"

# Session state with coarse-grained undo
cli-anything-godot --project mygame session status
cli-anything-godot --project mygame session undo

All commands support --json for structured output meant for agents.

REPL

No subcommand drops into an interactive REPL with history + completion:

cli-anything-godot --project mygame
> scene info main.tscn
> script inline -c 'print("hi")'
> exit

Upstream projects

• Godot Engine — the engine this CLI wraps. https://github.com/godotengine/godot
• HKUDS/CLI-Anything — the harness methodology and template. https://github.com/HKUDS/CLI-Anything

This repo extracts the Godot-specific wrapper from an internal agent-harness into a standalone, publicly installable Python package.

License

MIT. See LICENSE.