hera-unity plugin — Claude Code & Codex: live Unity Editor
hera-unity teaches a coding agent to drive a running Unity Editor through the hera-agent-unity CLI: scene reads, asset edits, Play Mode and tests.
Apache-2.0 ★ 1,596 updated 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install hera-unity@awesome-codex-pluginsWhat hera-unity does
The plugin gives a coding agent a skill for driving an open Unity Editor through the hera-agent-unity CLI. Scenes, assets, the Inspector, Play Mode, tests and screenshots all happen through commands.
Each run starts with doctor --json, status and a compact list of tools. Once something changes, the skill re-reads the affected state, looks for Unity console errors and runs focused tests or a Play Mode check when that fits.
You need the CLI and the Unity connector from the project's main repository, plus an open Unity project, before the skill has anything to talk to. Traffic stays on localhost; review commands that touch assets or execute arbitrary C# before you approve them.
What it helps with
- read the current scene without switching to the Editor
- catch console errors right after a script edit
- run focused tests or a Play Mode check from the chat
- adjust a component in the Inspector by describing the change
- grab a screenshot from the running game
Example prompts for the agent
- Run
doctor --jsonagainst Unity and tell me what's broken - Open
Assets/Scenes/Main.unity, enter Play Mode and take a screenshot - Change the player speed in the Inspector, then re-read the console for errors
How to install hera-unity
Plugin marketplace
/plugin marketplace add hashgraph-online/awesome-codex-plugins/plugin install hera-unity@awesome-codex-pluginsStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about hera-unity
How do I install hera-unity in Claude Code?
Add the marketplace first: /plugin marketplace add hashgraph-online/awesome-codex-plugins. Then install the plugin with /plugin install hera-unity@awesome-codex-plugins.
What does hera-unity do?
It hands the agent a skill for working with a live Unity Editor via the hera-agent-unity CLI: reading scenes and assets, making edits, checking the console, running tests and Play Mode.
What has to be set up before first use?
The CLI and the Unity connector from the project's main repository. A Unity project also needs to be open, otherwise the skill has nothing to connect to.
Source text
hera-agent-unity · Apache-2.0
# Hera Unity Codex Plugin This plugin teaches Codex to use the `hera-agent-unity` CLI for live Unity Editor inspection, changes, and verification. ## Install from the publisher marketplace Add this repository as a Codex marketplace: ```bash codex plugin marketplace add NotNull92/hera-agent-unity --ref main ``` Then open Codex, run `/plugins`, choose **Hera Agent Unity**, and enable **Hera Unity**. The plugin is also mirrored in the HOL `awesome-codex-plugins` and `awesome-ai-plugins` catalogs. ## Prerequisites Install the CLI and Unity connector by following the [main project README](https://github.com/NotNull92/hera-agent-unity#install), then open the Unity project before using the skill. ## Verification The skill starts with `doctor --json`, `status`, and compact tool discovery. After changes it re-reads the affected state, checks Unity console errors, and runs focused tests or Play Mode checks when appropriate. ## Security Hera communicates with the local Unity Editor over localhost. Review commands before approving work that changes project assets or executes arbitrary C#. ## License Apache License 2.0. See [LICENSE](LICENSE) and [NOTICE](NOTICE).
© NotNull92 · Apache-2.0 · hashgraph-online/awesome-codex-plugins