FAQ and Troubleshooting

FAQ & Troubleshooting

Find answers to common questions and solutions to frequent issues below.

❓ Frequently Asked Questions

Does this integration cost money?

The integration itself is free and open-source. However, using AI models from providers like OpenAI or Anthropic usually requires a paid API key. Local models via Ollama are completely free to run.

Can the AI delete my files?

The AI only suggests changes. It cannot save files to your disk directly without your explicit interaction (clicking the "Save" button in the editor). You always remain in control of your configuration.

Which files can I edit?

You can edit any text-based file in your /config directory, including .yaml, .py, .json, .md, .txt, and .js. Binary files like images or databases cannot be opened in the editor.

Can I use this on a mobile phone?

Yes! The card is responsive and will switch to a vertical layout on smaller screens. However, for complex coding tasks, a tablet or desktop is recommended.

---

🛠 Troubleshooting

The card is blank or won't load

• Make sure you have cleared your browser cache after installing or updating the integration.
• Check the Home Assistant logs (Settings > System > Logs) for any errors related to ai_code_task.
• Ensure you have restarted Home Assistant after installation.

I can't see any AI providers in the list

• Verify that you have at least one integration configured that supports the AI Task platform (e.g., xAI Conversation).
• Standard "Conversation" agents (like the default OpenAI config) might not appear unless they are exposed as an ai_task entity.

"Permission Denied" when saving files

• This usually happens if the Home Assistant process doesn't have write permissions to a specific file or folder.
• If you are running HA in Docker, ensure the volumes are mounted with the correct permissions.

The AI generates Hallucinated Entity IDs

• Make sure to use the Entity Selector (Database icon) to attach your actual entities to the chat.
• Briefly mention the entity types you are working with in your prompt.

"File is too large"

• To ensure performance, the editor has a size limit for the files it can open (typically 2MB). For very large files, consider splitting them or using an external editor.

---

📝 Reporting Bugs

If you encounter an issue not listed here, please open an issue on GitHub with:

1. A clear description of the problem.
2. Your Home Assistant version.
3. Any relevant error logs from the browser console and the HA backend.