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

Open

#208 opened on Apr 12, 2026 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language: JavaScript
Stars: 33.3k
Forks: 2.3k
PR merge metrics: No merged PRs in 30d

Description

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

Contributor guide

No contributing guide indexed for this repository

First steps

Read the whole issue, then the project's contributing guide.
Comment on the issue to say you are picking it up — it saves two people doing the same work.
Fork the repository and make your change on a branch.
Open a pull request that references the issue number.

Research direction

Start by reproducing the /plugin marketplace add, /plugin install, and /reload-plugins sequence, then inspect ~/.claude/settings.json for the enabledPlugins entry. Done means the installed plugin is enabled and /codex:setup, /codex:review, and /codex:rescue no longer return Unknown skill.

Written by the indexing model from the issue text.

Assessment

Tech stack: javascript, json, nodejs
Domain: cli, tooling
Issue type: Bug
Difficulty: 4/5
Estimated time: 3-5 days
Activity status: Quiet
Clarity: Mostly clear
Newbie friendliness: 48/100