codex - 💡(How to fix) Fix Separate installed plugins from per-session skill metadata injection [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openai/codex#21425Fetched 2026-05-07 03:40:17
View on GitHub
Comments
1
Participants
2
Timeline
6
Reactions
0
Timeline (top)
labeled ×5commented ×1

Fix Action

Fix / Workaround

The current workaround is to disable plugins globally in config.toml, but that is not a clean workflow: a user may want a plugin installed and available for another session without paying its full skills metadata cost in every coding session.

Code Example

Skill descriptions were shortened to fit the 2% skills context budget. Codex can still see every skill, but some descriptions are shorter. Disable unused skills or plugins to leave more room for the rest.
RAW_BUFFERClick to expand / collapse

What problem does this solve?

Codex currently treats enabled plugins/skills as part of the model-visible skills metadata surface for every new session. With several official plugins enabled, this can quickly hit the fixed skills metadata budget and produce warnings like:

Skill descriptions were shortened to fit the 2% skills context budget. Codex can still see every skill, but some descriptions are shorter. Disable unused skills or plugins to leave more room for the rest.

The current workaround is to disable plugins globally in config.toml, but that is not a clean workflow: a user may want a plugin installed and available for another session without paying its full skills metadata cost in every coding session.

Why this is not only a budget-size issue

Related issues already cover important parts of this:

  • #19679 asks for the hardcoded 2% budget to be configurable.
  • #19090 covers truncation effects in the injected Available skills metadata.
  • #19957 covers long first-party plugin skill descriptions.

Those would help, but there is a separate product/control-surface issue: plugin installation/enabling is currently too tightly coupled to per-session prompt injection.

For example, a user may want these different modes:

  • keep a document/PPT/spreadsheet plugin installed, but not inject its skills into every normal coding session;
  • start a dedicated session with those plugin skills fully injected;
  • keep Browser Use or Computer Use always available;
  • avoid duplicate or near-duplicate skill metadata across plugin/local/project sources;
  • prioritize repo-local skills over low-frequency plugin skills when metadata budget is tight.

Today the practical choice is mostly either keep everything enabled and accept truncation, or disable plugins globally and remember to re-enable them before a specialized session.

Requested behavior

Please consider separating plugin/skill availability from default per-session skills metadata injection. Possible designs:

  • per-session or profile-based plugin sets, e.g. default, docs, browser, research;
  • a config mode per plugin/skill such as inject = "always" | "on_demand" | "off" while keeping the plugin installed;
  • lazy loading: inject a compact plugin/skill manifest first, then load detailed routing metadata only when the user invokes or references that capability;
  • priority/pinning rules so repo-local or user-pinned skills are preserved before low-frequency plugin skills;
  • automatic deduplication of identical or overlapping skill metadata across plugin/local/project roots before applying the budget;
  • Codex App UI controls to start a new session with selected plugins instead of editing config.toml and restarting.

Expected result

Users should be able to keep official plugins installed without each one consuming skills metadata budget in every session. The default coding session stays compact, while specialized plugin-heavy sessions remain easy to start intentionally.

Environment

  • Codex CLI: codex-cli 0.128.0
  • Platform: macOS
  • Scenario: multiple official plugins enabled via ~/.codex/config.toml, fresh session shows the 2% skills context budget warning.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

codex - 💡(How to fix) Fix Separate installed plugins from per-session skill metadata injection [1 comments, 2 participants]