cli-anything-godot

# Godot Engine CLI Agent-native CLI for the Godot game engine. Manage projects, scenes, exports, and GDScript execution from the command line. ## Installation ```bash pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=godot/agent-harness ``` ## Requirements - Godot 4.x on PATH (or set GODOT_BIN env var) ## Commands ### Project Management ```bash # Create a new Godot project cli-anything-godot project create <path> [--name "My Game"] # Get project info (name, features, main scene) cli-anything-godot --json -p <project> project info # List all scenes cli-anything-godot --json -p <project> project scenes # List all scripts cli-anything-godot --json -p <project> project scripts # List all resources cli-anything-godot --json -p <project> project resources # Re-import project resources cli-anything-godot -p <project> project reimport ``` ### Scene Operations ```bash # Create a new scene with root node type cli-anything-godot -p <project> scene create scenes/Level1.tscn --root-type Node3D # Read scene structure (nodes, resources, connections) cli-anything-godot --json -p <project> scene read scenes/Level1.tscn # Add a child node to a scene cli-anything-godot -p <project> scene add-node scenes/Level1.tscn --name Player --type CharacterBody3D --parent . ``` ### GDScript Execution ```bash # Run a GDScript file (must extend SceneTree) cli-anything-godot -p <project> script run tools/build_navmesh.gd # Run inline GDScript code cli-anything-godot -p <project> script inline 'print(ProjectSettings.get_setting("application/config/name"))' # Validate GDScript syntax cli-anything-godot -p <project> script validate scripts/player.gd ``` ### Export ```bash # List configured export presets cli-anything-godot --json -p <project> export presets # Export all presets cli-anything-godot -p <project> export build # Export a specific preset cli-anything-godot -p <project> export build --preset "Windows Desktop" --output build/game.exe ``` ### Engine ```bash # Check Godot availability and binary path cli-anything-godot --json engine status # Get engine version cli-anything-godot engine version ``` ## JSON Mode Add `--json` flag to any command for structured JSON output suitable for agent consumption: ```bash cli-anything-godot --json -p ./my-game project info ``` ## Interactive REPL ```bash cli-anything-godot -p ./my-game session ```