mcpField
C
cli-anything-godot

cli-anything-godot

github.com/hkudsDevelopment57.6k556 installsUpdated 5w ago
Repository

About cli-anything-godot

cli-anything-godot is an agent-oriented command-line interface for managing Godot game projects. It covers project and scene operations, GDScript execution and validation, and export builds, with JSON output for agent workflows.

Key features

  1. 01Create and inspect Godot projects
  2. 02Read and modify scene structures
  3. 03Run and validate GDScript
  4. 04Inspect export presets and build exports
  5. 05Check Godot availability and version
  6. 06Return structured JSON output

Use cases

  1. 01Create a Godot project and inspect its scenes
  2. 02Add nodes to a game scene
  3. 03Run or validate project scripts
  4. 04Build an export using a configured preset

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/hkuds/cli-anything --skill cli-anything-godot

After installing, type/cli-anything-godotin Claude Code to confirm it loaded.

Details

From the project README

Godot Engine CLI

Agent-native CLI for the Godot game engine. Manage projects, scenes, exports, and GDScript execution from the command line.

Installation

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
# 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
# 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
# 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
# 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
# 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:

cli-anything-godot --json -p ./my-game project info

Interactive REPL

cli-anything-godot -p ./my-game session

Comments

Markdown supported