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 — reserved for screenshots that actually explain useful behavior.

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.