Codex plugins · Windows

Installed Codex plugin does not appear

Files on disk only prove the download completed. Registration, enablement, loading, and a real tool call must be verified separately.

Updated July 11, 2026 · 5 min

Identify the failing layer

  1. Files: verify the plugin directory and entry point.
  2. Registration: validate the marketplace manifest and plugin entry.
  3. Enablement: check both plugin and individual skill toggles.
  4. Runtime: restart the app and make a read-only tool call.
RiskBack up the relevant configuration before deleting any cache. A broad reset can remove unrelated plugin state.

Investigation order

  1. Record whether the plugin is missing or installed but unloaded.
  2. Validate the manifest as UTF-8 JSON without a byte order mark where possible.
  3. Confirm all required skills are enabled.
  4. Fully restart Codex so it reloads the manifest.
  5. Verify one real, read-only tool result. A visible list entry alone is not enough.

Success checks

  • The plugin appears and is enabled.
  • Its tools are visible.
  • A real read-only call succeeds after restart.