Skip to content

Bug: /plugin install does not add plugin to enabledPlugins, causing 'Unknown skill' on all commands #208

@lmanchu

Description

@lmanchu

Summary

After following the install instructions exactly, all /codex:* commands return Unknown skill: codex:setup (or similar). The root cause is that /plugin install codex@openai-codex installs the plugin files but does not write the entry to enabledPlugins in ~/.claude/settings.json, so Claude Code never loads the plugin.

Steps to Reproduce

/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup

Expected: Codex setup check runs.
Actual: Unknown skill: codex:setup

Root Cause

~/.claude/settings.json contains an enabledPlugins map that controls which plugins Claude Code actually loads. After /plugin install, the plugin files are downloaded to the cache correctly, but the key codex@openai-codex: true is never written to enabledPlugins.

Inspecting the file after install:

{
  "enabledPlugins": {
    "gh-cli@robbyt-claude-skills": true,
    "feature-dev@claude-code-plugins": true,
    ...
    // codex@openai-codex is missing entirely
  }
}

Workaround

Manually add the entry to ~/.claude/settings.json:

{
  "enabledPlugins": {
    ...
    "codex@openai-codex": true
  }
}

Then run /reload-plugins. After this, all commands (/codex:setup, /codex:review, /codex:rescue, etc.) work correctly.

Environment

  • Claude Code: 2.1.104
  • Codex CLI: 0.120.0
  • Plugin version: 1.0.2
  • OS: macOS 15 (Apple Silicon)
  • Node: v25.6.1

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions