# Unity Agentic Tools

> Use for Unity project automation via the unity-agentic-tools CLI and live Editor bridge: discover and run Unity commands (list/run/stream), install or troubleshoot the bridge, create/update/delete GameObjects, components, scenes, prefabs, and assets, query hierarchies and UI, run Play Mode tests, capture screenshots, and read console logs. Triggers: Unity Editor automation, scene or prefab edits,…

- **Type:** Skill
- **Install:** `agentstack add skill-taconotsandwich-unity-agentic-tools-unity-agentic-tools`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [taconotsandwich](https://agentstack.voostack.com/s/taconotsandwich)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [taconotsandwich](https://github.com/taconotsandwich)
- **Source:** https://github.com/taconotsandwich/unity-agentic-tools/tree/main/skills/unity-agentic-tools

## Install

```sh
agentstack add skill-taconotsandwich-unity-agentic-tools-unity-agentic-tools
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Unity Agentic Tools

Use this skill for Unity Agentic Tools CLI setup, command discovery, command execution, live Editor bridge workflows, and high-level project automation.

**CRITICAL: Use the CLI command runner for Unity operations. Do not manually mutate Unity serialized files (`.unity`, `.prefab`, `.asset`, `.mat`, `.anim`, `.controller`, `.meta`, `ProjectSettings/`) unless the user explicitly asks for raw file work.**

## Command Surface

| Command | What it does |
|---------|-------------|
| `list [query]` | Discover built-in aliases, attributed project commands, and optional raw static APIs. `--brief` omits per-argument detail; `--raw` adds raw statics |
| `run  [args...]` | Execute a command alias or raw public static C# method/property through the Unity bridge |
| `stream [topic]` | Watch real-time bridge events over WebSocket |
| `install` | Install the Unity bridge package |
| `uninstall` | Remove the Unity bridge package |
| `cleanup` | Remove stale bridge state or rebuildable `.unity-agentic` caches |
| `status` | Check command runner and bridge reachability, plus a `readiness` block saying what the Editor is busy with |

Commands emit compact single-line JSON by default; pass `--pretty` for indented output. Prefer `list  --brief` for discovery.

By default, `install` writes the GitHub package URL. For local bridge package development, use `install --local [path]`; existing `file:` dependencies are preserved unless `install --remote` is passed.

## Default Route

1. `unity-agentic-tools status -p `
2. `unity-agentic-tools list  --brief -p `
3. Inspect current state with `query.*`, `scene.hierarchy`, `ui.snapshot`, or screenshots.
4. `unity-agentic-tools run  ... -p `
5. Verify with the matching query, snapshot, screenshot, tests, or console stream.

## Examples

```bash
unity-agentic-tools list scene --brief -p 
unity-agentic-tools run project.refresh -p 
unity-agentic-tools run query.scene Assets/Scenes/Main.unity -p 
unity-agentic-tools run create.gameobject Assets/Scenes/Main.unity EnemyRoot Gameplay -p 
unity-agentic-tools run update.transform Assets/Scenes/Main.unity Player 1,2,3 0,90,0 1,1,1 -p 
unity-agentic-tools stream console --type Error -p 
unity-agentic-tools cleanup --cache -p 
```

Pass a structured argument positionally in single quotes — the CLI encodes the outer JSON array itself, so no escaping is needed. Reserve `--args ''` for arguments starting with `-`. See `reference/troubleshooting.md` "JSON Args".

```bash
unity-agentic-tools run update.batch Assets/Scenes/Main.unity '[{"gameObjectPath":"Player","propertyPath":"m_Name","value":"Hero"}]' -p 
```

Raw public static APIs can be called directly when no alias or `[AgenticCommand]` wrapper exists.

```bash
unity-agentic-tools run UnityEditor.AssetDatabase.Refresh -p 
unity-agentic-tools run UnityEditor.EditorApplication.ExecuteMenuItem "File/Save" -p 
```

## Project Commands

Do not add a new CLI command for each Unity operation. Expose project-specific behavior by adding `[AgenticCommand]` to public static methods/properties in Unity Editor C#:

```csharp
using UnityAgenticTools.Commands;

public static class BuildCommands
{
    [AgenticCommand("build.addressables", "Build Addressables content.")]
    public static object BuildAddressables(string profile)
    {
        return new { success = true, profile };
    }
}
```

Then use:

```bash
unity-agentic-tools list build --brief -p 
unity-agentic-tools run build.addressables Production -p 
```

## References

- `reference/live-editor-workflows.md`: live Editor setup, mutation, UI, and batch workflows
- `reference/command-reference.md`: generated alias reference with arg hints (`` `[optional]`)
- `reference/troubleshooting.md`: bridge, timeouts, refs, JSON args, and verification

## Troubleshooting

Full detail lives in `reference/troubleshooting.md`. Quick pointers:

- **Bridge won't connect**: see "Bridge Not Reachable" (install, open Unity, wait for compile, status, cleanup). `reachable: true` with `is_stable: false` means busy, not broken.
- **Long builds time out**: `run` defaults to 60s; see "Long-running Commands" (`--timeout 1200000`, `--no-wait`).
- **Play mode looks wrong right after `play.enter`**: the response reports the current state, not the requested one. Poll `play.state`; see "Play Mode Transitions" in `reference/live-editor-workflows.md`.
- **Reads are slow during a transition**: expected. Reads wait out a domain reload for up to 30s instead of failing; see "Domain reloads" in "Long-running Commands".
- **Stale `@hN`/`@uN` refs**: re-run `scene.hierarchy` or `ui.snapshot`; see "Stale Refs".
- **Need console logs**: `unity-agentic-tools stream console --duration 5000 -p `.
- **Need raw APIs**: `unity-agentic-tools list  --raw -p `.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [taconotsandwich](https://github.com/taconotsandwich)
- **Source:** [taconotsandwich/unity-agentic-tools](https://github.com/taconotsandwich/unity-agentic-tools)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-taconotsandwich-unity-agentic-tools-unity-agentic-tools
- Seller: https://agentstack.voostack.com/s/taconotsandwich
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.