cli-anything-godot について
cli-anything-godotは、Godotゲームプロジェクトを管理するエージェント向けコマンドラインツールです。プロジェクトやシーンの操作、GDScriptの実行と検証、エクスポートビルドに対応し、エージェントのワークフロー向けにJSONを出力できます。
主な機能
- 01Godotプロジェクトの作成と確認
- 02シーン構造の読み取りと変更
- 03GDScriptの実行と検証
- 04エクスポートプリセットの確認とビルド
- 05Godotの利用可否とバージョンの確認
- 06構造化JSONの出力
活用シーン
- 01Godotプロジェクトを作成してシーンを確認
- 02ゲームシーンにノードを追加
- 03プロジェクトのスクリプトを実行または検証
- 04設定済みプリセットを使ってエクスポートをビルド
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ hkuds/ cli-anything --skill cli-anything-godotインストール後、Claude Code で/cli-anything-godotを入力して読み込まれたか確認します。
詳細
Godot Engine CLI
Godot ゲームエンジン向けのエージェントネイティブ CLI です。コマンドラインからプロジェクト、シーン、エクスポート、GDScript の実行を管理できます。
インストール
pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=godot/agent-harness
要件
- PATH に Godot 4.x が必要です(または GODOT_BIN 環境変数を設定してください)
コマンド
プロジェクト管理
# 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
シーン操作
# 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 の実行
# 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
エクスポート
# 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
エンジン
# Check Godot availability and binary path
cli-anything-godot --json engine status
# Get engine version
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
コメント
Markdown 対応