Compatibility and Limitations

Compatibility and Limitations

Codex Assist is experimental pre-1.0 software.

Current support target

• Home Assistant 2026.5.0 or newer.
• HACS custom repository installation.
• ChatGPT/Codex account sign-in through device-code auth.
• Native Home Assistant Assist conversation-agent registration.
• Home Assistant Assist LLM API tool calls for exposed-entity control.

Important caveat

This project is not affiliated with OpenAI or Home Assistant.

It follows the authentication approach used by the official OpenAI Codex CLI, but the downstream Codex service interface is not currently presented as a stable public third-party API for Home Assistant integrations. Compatibility may change with upstream Codex updates.

What Codex Assist is not

Codex Assist is not:

• the official Home Assistant OpenAI Conversation integration
• an OpenAI API-key based integration
• a raw Home Assistant service-call bridge
• a bypass around Assist exposed-entity controls

Known limitations

• Model availability can change upstream.
• Reauth may be needed if Codex invalidates a token.
• Real-world device control depends on Home Assistant entity exposure and device reliability.
• The integration should be tested carefully before daily household use.

Release maturity

The project is still early. Prefer harmless devices and read-only questions until your local setup is proven.