plugins.md +42 −11
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/>
53
54The CLI plugin browser groups plugins by marketplace. Use the marketplace tabs
55to switch sources, open a plugin to inspect details, install or uninstall
56marketplace entries, and press <kbd>Space</kbd> on an installed plugin to toggle
57its enabled state.
45 58
46### Install and use a plugin59### Install and use a plugin
47 60
48Once you open the plugin directory:61Once you open the plugin directory:
49 62
63<WorkflowSteps>
64
501. Search or browse for a plugin, then open its details.651. Search or browse for a plugin, then open its details.
512. Select the install button. In the app, select the plus button or662. Select the install button. In the app, select the plus button or
52 **Add to Codex**. In the CLI, select `Install plugin`.67 **Add to Codex**. In the CLI, select `Install plugin`.
55 use them.70 use them.
564. 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.
57 72
5873After you install a plugin, you can use it directly in the prompt window:</WorkflowSteps>
59 74
6075After you install a plugin, you can use it directly in the prompt window:
61 76
6277Describe 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/>
63 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">
64 Ask for the outcome you want, such as "Summarize unread Gmail threads87 Ask for the outcome you want, such as "Summarize unread Gmail threads
65 from today" or "Pull the latest launch notes from Google Drive."88 from today" or "Pull the latest launch notes from Google Drive."
6689 </p>
90 <p class="mt-3 text-sm text-secondary">
67 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
68 task.92 task.
93 </p>
94 </div>
69 95
7096Choose a specific plugin <div class="rounded-xl border border-subtle bg-surface px-5 py-4">
7197 <p class="text-sm font-semibold text-default">Choose a specific plugin</p>
98 <p class="mt-2 text-sm text-secondary">
72 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
73 explicitly.100 explicitly.
74101 </p>
102 <p class="mt-3 text-sm text-secondary">
75 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
76104should 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{" "}
77105[Skills](https://developers.openai.com/codex/skills). <a href="/codex/skills">Skills</a>.
106 </p>
107 </div>
108</div>
78 109
79### How permissions and data sharing work110### How permissions and data sharing work
80 111