codex - 💡(How to fix) Fix Repository-scoped marketplace and plugin configuration in project config [1 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#18115Fetched 2026-04-17 08:32:38
View on GitHub
Comments
0
Participants
1
Timeline
6
Reactions
0
Author
Participants
Timeline (top)
labeled ×4unlabeled ×2

Root Cause

Today, marketplace registrations and plugin states are effectively read from user config, so each developer must configure Codex manually.

Repo-scoped plugin config would improve:

  • onboarding
  • reproducibility across machines
  • team-shared tooling
  • multi-repo plugin development and consumption

Code Example

[marketplaces.my_team]
source = "github.com/my-org/my-codex-marketplace"

[plugins."review-tools@my_team"]
enabled = true
RAW_BUFFERClick to expand / collapse

What variant of Codex are you using?

Codex CLI

What feature would you like to see?

Codex supports project config via ./.codex/config.toml, but plugin-related config is still effectively user-scoped.

A repo can provide a local marketplace via ./.agents/plugins/marketplace.json, but it cannot declare:

  • remote marketplaces that should be available for that repo
  • plugin enable/disable settings that should apply for that repo

This makes team-wide plugin setup hard to share and hard to reproduce across machines.

Request

Please add repo-scoped support for:

  • marketplace registration
  • plugin enable/disable settings

Ideally this should work through ./.codex/config.toml or an equivalent repo-local config mechanism, so teams can commit their Codex plugin setup to the repository.

Example:

[marketplaces.my_team]
source = "github.com/my-org/my-codex-marketplace"

[plugins."review-tools@my_team"]
enabled = true

Why this matters

Today, marketplace registrations and plugin states are effectively read from user config, so each developer must configure Codex manually.

Repo-scoped plugin config would improve:

  • onboarding
  • reproducibility across machines
  • team-shared tooling
  • multi-repo plugin development and consumption

Additional information

No response

extent analysis

TL;DR

To address the issue, consider adding support for repo-scoped plugin configuration through ./.codex/config.toml to manage marketplace registrations and plugin enable/disable settings.

Guidance

  • Review the current implementation of ./.codex/config.toml to understand how project config is handled and identify potential areas for extension to support plugin-related config.
  • Investigate the feasibility of adding a new section to ./.codex/config.toml for marketplace registration and plugin settings, similar to the proposed example.
  • Consider the potential impact on existing user-scoped configurations and how to handle conflicts or overrides between user and repo-scoped settings.
  • Evaluate the need for additional tooling or scripts to manage and synchronize plugin configurations across teams and repositories.

Example

[marketplaces.my_team]
source = "github.com/my-org/my-codex-marketplace"

[plugins."review-tools@my_team"]
enabled = true

This example illustrates the proposed syntax for declaring marketplace registrations and plugin settings in ./.codex/config.toml.

Notes

The implementation details and potential challenges of adding repo-scoped plugin configuration are not fully specified in the issue, so further investigation and discussion may be necessary to determine the best approach.

Recommendation

Apply workaround: Implement a custom solution using the proposed ./.codex/config.toml syntax to manage marketplace registrations and plugin settings at the repository level, as this would improve onboarding, reproducibility, and team-shared tooling.

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