--- title: Troubleshooting AI Generators for the Unity CLI product: Unity AI canonical: https://docs.unity.com/en-us/ai/generators-cli/troubleshoot last_updated: 2026-11-10 generated_at: 2026-11-11T14:47:19.593Z locale: en-us --- # Troubleshooting AI Generators for the Unity CLI > Solve common issues with AI Generators for the Unity CLI, such as failed setup checks and interrupted generations. When a `unity ai` command doesn't work, use `unity ai doctor` to find the cause and the fix. ## Diagnose your setup `unity ai doctor` is free, read-only, and never prints your sign-in token. To run it: ```bash unity ai doctor ``` The command checks the following items, and shows the command that fixes each failed check: * Unity CLI and `ai` plugin installation, including available updates. * Sign-in and the organization in use. * Access to AI Generators for your organization, acceptance of the terms of service, and the Unity Credits balance. * Agent skill installation. * Preview prerequisites, such as Node.js. * Spending limits. Fix the first failed check first, because later checks often depend on it. Then run `unity ai doctor` again. If you work through an AI agent, ask the agent to run `unity ai doctor`. The agent can often fix the issue for you. ## Fix command errors Most errors include a code, a message, and the steps that fix them. If a generation fails after you submit it, the output says whether Unity might still charge you and how to save the result without paying again. If you stop a command after it submits a generation, for example by pressing **Ctrl**+**C**, the generation keeps running and might still consume Unity Credits. Don't run the same request again, because Unity charges for it again. To save the output without paying again, follow these steps: 1. Find the job ID on the `submitted:` line that the command printed. 2. Run the `unity ai jobs status` command that the output printed when you stopped the original command. For example: ```bash unity ai jobs status --org --model --wait --out ``` ## Additional resources * [Get started with AI Generators for the Unity CLI](./get-started.md) * [Troubleshoot Unity Credits issues](/ai/credits/credits-troubleshoot.md) * [Configure Unity's AI settings](/ai/unity-dashboard/ai-settings.md)