plugins.md +40 −13
30 30
31Open **Plugins** in the Codex app to browse and install curated plugins.31Open **Plugins** in the Codex app to browse and install curated plugins.
32 32
3333<CodexScreenshot
34 alt="Codex Plugins page"
35 lightSrc="/images/codex/plugins/directory.png"
36 darkSrc="/images/codex/plugins/directory_dark.png"
37/>
34 38
35### Plugin directory in the CLI39### Plugin directory in the CLI
36 40
41/plugins45/plugins
42```46```
43 47
4448<CodexScreenshot
49 alt="Plugins list in Codex CLI"
50 lightSrc="/images/codex/plugins/cli_light.png"
51 darkSrc="/images/codex/plugins/codex-plugin-cli.png"
52/>
45 53
46The CLI plugin browser groups plugins by marketplace. Use the marketplace tabs54The CLI plugin browser groups plugins by marketplace. Use the marketplace tabs
4755to switch sources, open a plugin to inspect details, and press `Space`to switch sources, open a plugin to inspect details, install or uninstall
4856on an installed plugin to toggle its enabled state.marketplace entries, and press <kbd>Space</kbd> on an installed plugin to toggle
57its enabled state.
49 58
50### Install and use a plugin59### Install and use a plugin
51 60
52Once you open the plugin directory:61Once you open the plugin directory:
53 62
63<WorkflowSteps>
64
541. Search or browse for a plugin, then open its details.651. Search or browse for a plugin, then open its details.
552. Select the install button. In the app, select the plus button or662. Select the install button. In the app, select the plus button or
56 **Add to Codex**. In the CLI, select `Install plugin`.67 **Add to Codex**. In the CLI, select `Install plugin`.
59 use them.70 use them.
604. After installation, start a new thread and ask Codex to use the plugin.714. After installation, start a new thread and ask Codex to use the plugin.
61 72
6273After you install a plugin, you can use it directly in the prompt window:</WorkflowSteps>
63 74
6475After you install a plugin, you can use it directly in the prompt window:
65 76
6677Describe the task directly<CodexScreenshot
78 alt="Codex Plugins page"
79 lightSrc="/images/codex/plugins/plugin-github-invoke.png"
80 darkSrc="/images/codex/plugins/plugin-github-invoke-dark.png"
81/>
67 82
83<div class="not-prose mt-4 grid gap-4 md:grid-cols-2">
84 <div class="rounded-xl border border-subtle bg-surface px-5 py-4">
85 <p class="text-sm font-semibold text-default">Describe the task directly</p>
86 <p class="mt-2 text-sm text-secondary">
68 Ask for the outcome you want, such as "Summarize unread Gmail threads87 Ask for the outcome you want, such as "Summarize unread Gmail threads
69 from today" or "Pull the latest launch notes from Google Drive."88 from today" or "Pull the latest launch notes from Google Drive."
7089 </p>
90 <p class="mt-3 text-sm text-secondary">
71 Use this when you want Codex to choose the right installed tools for the91 Use this when you want Codex to choose the right installed tools for the
72 task.92 task.
93 </p>
94 </div>
73 95
7496Choose a specific plugin <div class="rounded-xl border border-subtle bg-surface px-5 py-4">
7597 <p class="text-sm font-semibold text-default">Choose a specific plugin</p>
98 <p class="mt-2 text-sm text-secondary">
76 Type <code>@</code> to invoke the plugin or one of its bundled skills99 Type <code>@</code> to invoke the plugin or one of its bundled skills
77 explicitly.100 explicitly.
78101 </p>
102 <p class="mt-3 text-sm text-secondary">
79 Use this when you want to be specific about which plugin or skill Codex103 Use this when you want to be specific about which plugin or skill Codex
80104should use. See [Codex app commands](https://developers.openai.com/codex/app/commands) and should use. See <a href="/codex/app/commands">Codex app commands</a> and{" "}
81105[Skills](https://developers.openai.com/codex/skills). <a href="/codex/skills">Skills</a>.
106 </p>
107 </div>
108</div>
82 109
83### How permissions and data sharing work110### How permissions and data sharing work
84 111