Repository navigation
Home
itsreverence edited this page Nov 15, 2026
·
8 revisions
Codex Assist lets Home Assistant Assist and AI Task use OpenAI Codex / ChatGPT through Codex-style device-code sign-in. Device control stays inside Home Assistant's normal exposed-entity safety model.
Read these in order for a first setup.
- Installation takes you through the Marketplace or HACS, device-code sign-in, your Assist pipeline, and a first safe request.
- Safe Entity Exposure shows how to expose one entity, what leaves Home Assistant, and what to keep unexposed.
- Features and Options covers Assist, hosted web search, AI Task with a data-task example, image generation, and every agent and AI Task setting.
- Choosing a Model explains how the model list is found, what shows when discovery fails, and what to do when a saved model stops working.
- Troubleshooting covers sign-in, Assist setup, control, search, AI Task, and older upgrade problems.
- Compatibility and Limitations lists current support boundaries and upstream Codex caveats.
- Screenshots and UI Tour has two example screenshots, one of them from an older version.
- For setup and usage questions, start with this wiki and the repository support guide.
- For bugs and feature requests, use the repository issue forms.
- For vulnerabilities or exposed credentials, follow the security policy. Do not post sensitive details publicly.
These documents stay in the repository because they are versioned with the code and reviewed in pull requests.
- README gives the short install and feature overview.
- Security Policy defines the security and data boundaries.
- Architecture explains the implementation flow.
- Contributing covers development and pull requests.
- Testing covers local and Home Assistant verification.
- Releasing is the maintainer release checklist.
Use this wiki as the user manual. Use the repository docs as the source for behavior tied to the code.