Home

Codex Assist Wiki

Codex Assist lets Home Assistant Assist use OpenAI Codex / ChatGPT through Codex-style device-code sign-in, while keeping device control inside Home Assistant's normal exposed-entity safety model.

Start here

• Installation — add the HACS custom repository, install, restart, and configure Codex Assist.
• Choosing a Model — understand model selection, fallback slugs, and custom values.
• Safe Entity Exposure — decide what Assist should be allowed to see or control.
• Troubleshooting — fix missing entities, auth failures, and control issues.
• Compatibility and Limitations — current support boundaries and upstream Codex caveats.
• Screenshots and UI Tour — see the options flow and a safe exposed-light control example.

Support

• Setup and usage questions: start with this wiki and the repository support guide.
• Bugs and feature requests: use the repository issue forms.
• Vulnerabilities or exposed credentials: follow the security policy and do not post sensitive details publicly.

Canonical project docs

Some docs should stay in the repository because they are versioned with code and reviewed in pull requests:

• README — short install/value overview.
• Security Policy — canonical security stance and vulnerability reporting.
• Architecture — implementation flow.
• Workflow — development and release process.

Use this wiki as the friendly manual. Use repo docs as the canonical source for code-tied behavior.