Godot Engine CLI
CLI nativa para a engine Godot. Gerencie projetos, cenas, exportações e execução de GDScript a partir da linha de comando.
Instalação
pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=godot/agent-harness
Requisitos
- Godot 4.x no PATH (ou defina a variável de ambiente GODOT_BIN)
Comandos
Gerenciamento de Projetos
# Criar um novo projeto Godot
cli-anything-godot project create <caminho> [--name "Meu Jogo"]
# Obter informações do projeto (nome, recursos, cena principal)
cli-anything-godot --json -p <projeto> project info
# Listar todas as cenas
cli-anything-godot --json -p <projeto> project scenes
# Listar todos os scripts
cli-anything-godot --json -p <projeto> project scripts
# Listar todos os recursos
cli-anything-godot --json -p <projeto> project resources
# Reimportar recursos do projeto
cli-anything-godot -p <projeto> project reimport
Operações com Cenas
# Criar uma nova cena com tipo de nó raiz
cli-anything-godot -p <projeto> scene create cenas/Nivel1.tscn --root-type Node3D
# Ler estrutura da cena (nós, recursos, conexões)
cli-anything-godot --json -p <projeto> scene read cenas/Nivel1.tscn
# Adicionar um nó filho a uma cena
cli-anything-godot -p <projeto> scene add-node cenas/Nivel1.tscn --name Jogador --type CharacterBody3D --parent .
Execução de GDScript
# Executar um arquivo GDScript (deve estender SceneTree)
cli-anything-godot -p <projeto> script run ferramentas/construir_navmesh.gd
# Executar código GDScript inline
cli-anything-godot -p <projeto> script inline 'print(ProjectSettings.get_setting("application/config/name"))'
# Validar sintaxe GDScript
cli-anything-godot -p <projeto> script validate scripts/jogador.gd
Exportação
# Listar predefinições de exportação configuradas
cli-anything-godot --json -p <projeto> export presets
# Exportar todas as predefinições
cli-anything-godot -p <projeto> export build
# Exportar uma predefinição específica
cli-anything-godot -p <projeto> export build --preset "Windows Desktop" --output build/jogo.exe
Engine
# Verificar disponibilidade do Godot e caminho do binário
cli-anything-godot --json engine status
# Obter versão da engine
cli-anything-godot engine version
Modo JSON
Adicione a flag --json a qualquer comando para obter saída JSON estruturada, adequada para consumo por agentes:
cli-anything-godot --json -p ./meu-jogo project info
REPL Interativo
cli-anything-godot -p ./meu-jogo session