Cmd. /plugins
Browse installed and discoverable Codex plugins.
Key takeaways
/pluginsopens the plugin browser to inspect installed and discoverable plugins, install suggestions, or toggle plugin state.- Since 0.117.0 plugins became first-class with startup sync; later versions added marketplace sources (GitHub, git URLs, local dirs), workspace sharing, and source filtering.
codex plugin list --json(0.137.0) and--jsonoutput for add/remove and marketplace commands (0.138.0) make plugin inventory auditable for CI rather than scraping the UI.- Treat plugin installation as a trust and supply-chain decision, and review plugins with bundled hooks since they can alter the session lifecycle.
- Installation alone does not guarantee the tool surface is available; cross-check
/mcp,/apps, and explicit$mentions.
Original Command Declaration
/pluginsOfficial Summary
/plugins opens the plugin browser so you can inspect installed and discoverable plugins, review
capabilities, install suggested plugins, or toggle installed plugin state. In team operations, it is
also the entry point for plugin supply, sharing, source policy, and bundled hook review.
Usage
/pluginsGood Examples
- Check whether team-standard plugins synced correctly on a new machine.
- Before installing or removing a work-specific plugin, review current state and auth/setup requirements.
- Use
/hooksafter enabling plugin-bundled hooks to verify lifecycle behavior.
Similar Commands
| Command | Difference | Choose It When |
|---|---|---|
/plugins | Manages plugin bundles | You need packaged skills, apps, MCP, or hooks |
/apps | Browses app/connectors | You only need an app mention |
/mcp | Lists actual tool surface | You need tool-level availability |
Use Cases
- Inspecting installed plugin capabilities.
- Managing marketplace-sourced or workspace-shared plugins.
- Checking whether a capability is available because of a plugin.
- Onboarding plugin-provided Skills, MCP servers, Apps, and lifecycle hooks as one bundle.
v0.117.0 Changes
- Plugins became a first-class workflow with startup sync and clearer auth/setup handling.
- The
/pluginsbrowser became the place to start plugin discovery, install, and removal flows.
v0.121.0 to v0.125.0 Changes
codex marketplace addsupports GitHub, git URLs, local directories, and directmarketplace.jsonURLs, expanding how organizations manage plugin sources.- The plugin workflow grew into tabbed browsing, inline enable/disable toggles, marketplace removal, and remote, cross-repo, and local sources.
- In practice,
/pluginsis no longer only an install menu. It is also the operational entry point for deciding which marketplaces and sources an organization allows. - 0.124.0 added remote plugin marketplace list/read support, making source inspection clearer.
- 0.125.0 expanded app-server plugin management with remote plugin installation and marketplace upgrade flows.
v0.129.0 to v0.130.0 Changes
- Workspace sharing, share access controls, source filtering, local share path tracking, marketplace
removal/upgrades, and remote bundle sync made
/pluginsa team distribution control surface. - Plugin details can show bundled hooks, so teams can see lifecycle behavior before trusting a plugin.
- Share-link metadata and discoverability controls make public and internal sharing boundaries clearer.
v0.131.0 to v0.139.0 Changes
- 0.131.0 added plugin marketplace CLI commands, version-aware sharing, share checkout, and clearer shared-workspace buckets.
- 0.133.0 improved marketplace-aware list output, installed versions, visible marketplace roots, and remote collection support.
- 0.137.0 added
codex plugin list --jsonand cached remote catalog suggestions, making plugin inventory easier to audit automatically. - 0.138.0 added
--jsonoutput for plugin add/remove and marketplace commands, and plugin detail data can expose default prompts, remote MCP servers, and unavailable app templates. - In the 0.138.0~0.139.0 baseline,
codex plugin list --available --jsonincludes uninstalled marketplace plugins, and JSON entries can includemarketplaceSource. - In the 0.139.0 baseline, marketplace operations should be treated together with install/upgrade flows and should log selected marketplaces, upgraded roots, and errors.
Cautions
- Treat plugin installation as a trust and supply-chain decision.
- Installation alone does not guarantee the actual tool surface is available; cross-check
/mcp,/apps, and explicit$mentions. - Treat plugins with bundled hooks as security/platform review candidates because they can alter the session lifecycle.
- CI and audit scripts should consume
codex plugin list --jsonandcodex plugin marketplace list --jsonrather than scraping the interactive/pluginsUI.
Release Basis
- Judgment: confirmed addition
- First evidence version:
rust-v0.117.0 - Date (UTC): 2026-03-26
- Release link: https://github.com/openai/codex/releases/tag/rust-v0.117.0
Sources
- Codex releases: https://github.com/openai/codex/releases/tag/rust-v0.117.0
- Codex changelog: https://developers.openai.com/codex/changelog