Hera Unity live editor
Use hera-agent-unity whenever work depends on the real Unity Editor state. Prefer dedicated commands over arbitrary C# execution.
Bootstrap
Run these commands in order when first connecting:
hera-agent-unity doctor --json
hera-agent-unity status
hera-agent-unity list --compact
Report the project, port, Unity version, state, and tool count. If Unity is unreachable, ask the user to open the project with the connector installed.
Working loop
- Read only the state needed for the task.
- Apply the scene, Inspector, asset, or code change.
- Compile or re-read the changed state.
- Check recent console errors.
- Run focused tests or Play Mode checks when behavior changed.
Useful commands:
hera-agent-unity scene info
hera-agent-unity console --type error --lines 20
hera-agent-unity editor refresh --compile
hera-agent-unity editor play --wait
hera-agent-unity test --mode PlayMode
hera-agent-unity screenshot --view game
Efficiency and safety
- Use
list --compact, bounded console reads, and shallowexec --depth 1responses. - Prefer
scene,console,editor,test,describe_type, and other dedicated commands overexec. - Batch related side effects into one
exec; returnnullor omit the return. - Never return a
UnityEngine.Objectdirectly. Return only the fields needed. - Branch on structured error
code, not message text. - Throw or use
--strictwhen a logical failure must produce a non-zero exit. - Treat
inputcommands as Unity EventSystem QA, not proof of a physical OS click.
The complete command and agent guide is at https://github.com/NotNull92/hera-agent-unity/blob/main/AGENTS.md.
Source: hashgraph-online/awesome-codex-plugins → plugins/NotNull92/hera-agent-unity/skills/live-editor/SKILL.md