core
exec — 런타임 C# 실행
임의 C# 코드를 Unity Editor에서 직접 실행. 전체 API 접근, 컴파일 캐시로 재호출 즉시 응답.
hera-agent-unity exec "return Camera.main.name;"
core
exec --check — 실행 전 문법 검증
코드를 돌리지 않고 문법만 먼저 확인. AI의 "실행 → 실패 → 재시도" 한 바퀴를 걸러냅니다.
hera-agent-unity exec --check "return Camera.main.name;"
core
editor — Play Mode 제어
play, stop, pause, refresh, compile. --wait 플래그로 상태 확정까지 블로킹.
hera-agent-unity editor play --wait
core
console — 로그 골라보기
error/warning/log 필터, stacktrace 제어, clear. GUI 콘솔 열지 않고 터미널에서.
hera-agent-unity console --type error
core
scene — 씬 정보·로드·저장·목록·닫기
활성 씬 정보, Build Settings 등록 씬 목록, additive 로드, 저장, 닫기.
hera-agent-unity scene load Main --mode additive
core
test — EditMode/PlayMode
Unity Test Framework 통합. 필터링, 결과 파일 폴링, domain-reload 안전.
hera-agent-unity test --mode PlayMode --filter MyTest
core
profiler — 성능 분석
Profiler 계층을 GUI 클릭 없이 한 줄로. 정렬·깊이·임계값으로 핫스팟만 직접 가져옵니다.
hera-agent-unity profiler hierarchy --depth 5 --sort self
core
screenshot — 화면 캡처
Scene View 또는 Game View 캡처. 자동화 문서, CI 스크린샷 비교에 활용.
hera-agent-unity screenshot --view game
core
batch — 여러 명령 한 번에
JSON 파일로 여러 명령을 묶어 한 번에 실행. CI/CD에서 왕복 횟수를 줄입니다.
hera-agent-unity batch --file deploy.json
introspection
describe_type — 살아있는 API 보기
지금 돌고 있는 코드에서 타입·메서드·시그니처를 직접 가져옵니다. LLM 학습 cutoff 추측이 아니라 라이브 상태.
hera-agent-unity describe_type UnityEditor.EditorApplication
introspection
find_method — 메서드 직접 검색
로드된 어셈블리에서 메서드를 리플렉션으로 검색. namespace 필터, 시그니처 확인.
hera-agent-unity find_method Refresh --namespace UnityEditor
introspection
list_assemblies — 어셈블리 목록
현재 프로젝트에 로드된 모든 어셈블리를 나열. 버전, 경로 포함.
hera-agent-unity list_assemblies
introspection
unity_docs — 오프라인 Unity 문서
Unity ScriptReference를 오프라인으로 조회. 네트워크 없이, Unity 버전에 맞는 정확한 API 정보.
hera-agent-unity unity_docs GameObject
gameobject
manage_gameobject — 게임오브젝트 CRUD
생성, 삭제, 이름 변경, 부모 설정, 활성화/비활성화. HierarchyPath로 정확한 경로 지정.
hera-agent-unity manage_gameobject create --name Player --parent /World
gameobject
find_gameobjects — 오브젝트 검색
이름, 태그, 컴포넌트로 게임오브젝트를 검색. inactive 오브젝트도 포함 옵션.
hera-agent-unity find_gameobjects --name Enemy --inactive
gameobject
manage_components — 컴포넌트 CRUD
컴포넌트 추가, 제거, 속성 수정. SerializedProperty 경로로 깊은 속성까지 접근.
hera-agent-unity manage_components --target Player --add Rigidbody
asset
manage_material — 머티리얼 편집
쉐이더 속성 조회, 머티리얼 생성/수정. 색상, 텍스처, 벡터 값 설정.
hera-agent-unity manage_material --create NewMat --shader URP/Lit
asset
manage_prefab — 프리팹 관리
프리팹 생성, 인스턴스화, 컴포넌트 추가/제거. PrefabStage 없이 headless로.
hera-agent-unity manage_prefab --create-from Player --path Assets/Prefabs
asset
describe_shader — 쉐이더 속성 조회
쉐이더의 property 이름, 타입, display label, range를 확인. 머티리얼 편집 전 필수.
hera-agent-unity describe_shader URP/Lit --list
asset
manage_asset_import — 임포트 설정
TextureImporter, ModelImporter 등의 임포트 설정을 SerializedProperty로 직접 수정.
hera-agent-unity manage_asset_import --path Assets/Textures --set textureType Sprite
ui
manage_ui — uGUI 오서링
Canvas, Panel, Button, Text 등 uGUI 요소 생성. RectTransform anchor/pivot/preset 설정.
hera-agent-unity manage_ui create --type button --text "Start"
package
manage_packages — UPM 패키지 관리
패키지 설치, 제거, 임베드. git URL, registry, 로컬 파일 모두 지원.
hera-agent-unity manage_packages add com.unity.cinemachine
custom
내 도구 ([HeraTool])
C# 클래스에 [HeraTool] 속성을 붙이면 자동으로 CLI 명령이 됩니다. 프로젝트 전용 도구를 쉽게 추가.
hera-agent-unity list # 등록된 도구 목록 확인
