cli-anything-godot

Godot Engine CLI

Godotゲームエンジン向けのエージェントネイティブCLI。コマンドラインからプロジェクト、シーン、エクスポート、GDScriptの実行を管理します。

インストール

pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=godot/agent-harness

要件

• Godot 4.x が PATH に存在する（または GODOT_BIN 環境変数で指定する）

コマンド

プロジェクト管理

# 新しいGodotプロジェクトを作成
cli-anything-godot project create <path> [--name "マイゲーム"]

# プロジェクト情報を取得（名前、機能、メインシーン）
cli-anything-godot --json -p <project> project info

# すべてのシーンを一覧表示
cli-anything-godot --json -p <project> project scenes

# すべてのスクリプトを一覧表示
cli-anything-godot --json -p <project> project scripts

# すべてのリソースを一覧表示
cli-anything-godot --json -p <project> project resources

# プロジェクトリソースを再インポート
cli-anything-godot -p <project> project reimport

シーン操作

# ルートノードタイプを指定して新しいシーンを作成
cli-anything-godot -p <project> scene create scenes/Level1.tscn --root-type Node3D

# シーン構造を読み取り（ノード、リソース、接続）
cli-anything-godot --json -p <project> scene read scenes/Level1.tscn

# シーンに子ノードを追加
cli-anything-godot -p <project> scene add-node scenes/Level1.tscn --name Player --type CharacterBody3D --parent .

GDScriptの実行

# GDScriptファイルを実行（SceneTreeを継承している必要あり）
cli-anything-godot -p <project> script run tools/build_navmesh.gd

# インラインGDScriptコードを実行
cli-anything-godot -p <project> script inline 'print(ProjectSettings.get_setting("application/config/name"))'

# GDScriptの構文を検証
cli-anything-godot -p <project> script validate scripts/player.gd

エクスポート

# 設定済みのエクスポートプリセットを一覧表示
cli-anything-godot --json -p <project> export presets

# すべてのプリセットをエクスポート
cli-anything-godot -p <project> export build

# 特定のプリセットをエクスポート
cli-anything-godot -p <project> export build --preset "Windows Desktop" --output build/game.exe

エンジン

# Godotの利用可能性とバイナリパスを確認
cli-anything-godot --json engine status

# エンジンバージョンを取得
cli-anything-godot engine version

JSONモード

任意のコマンドに --json フラグを追加すると、エージェントが処理しやすい構造化JSON出力が得られます：

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

対話型REPL

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