plugins.md +37 −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/>
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
47to switch sources, open a plugin to inspect details, install or uninstall55to switch sources, open a plugin to inspect details, install or uninstall
52 60
53Once you open the plugin directory:61Once you open the plugin directory:
54 62
63<WorkflowSteps>
64
551. Search or browse for a plugin, then open its details.651. Search or browse for a plugin, then open its details.
562. Select the install button. In the app, select the plus button or662. Select the install button. In the app, select the plus button or
57 **Add to Codex**. In the CLI, select `Install plugin`.67 **Add to Codex**. In the CLI, select `Install plugin`.
60 use them.70 use them.
614. 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.
62 72
6373After you install a plugin, you can use it directly in the prompt window:</WorkflowSteps>
64 74
6575After you install a plugin, you can use it directly in the prompt window:
66 76
6777Describe 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/>
68 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">
69 Ask for the outcome you want, such as "Summarize unread Gmail threads87 Ask for the outcome you want, such as "Summarize unread Gmail threads
70 from today" or "Pull the latest launch notes from Google Drive."88 from today" or "Pull the latest launch notes from Google Drive."
7189 </p>
90 <p class="mt-3 text-sm text-secondary">
72 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
73 task.92 task.
93 </p>
94 </div>
74 95
7596Choose a specific plugin <div class="rounded-xl border border-subtle bg-surface px-5 py-4">
7697 <p class="text-sm font-semibold text-default">Choose a specific plugin</p>
98 <p class="mt-2 text-sm text-secondary">
77 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
78 explicitly.100 explicitly.
79101 </p>
102 <p class="mt-3 text-sm text-secondary">
80 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
81104should 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{" "}
82105[Skills](https://developers.openai.com/codex/skills). <a href="/codex/skills">Skills</a>.
106 </p>
107 </div>
108</div>
83 109
84### How permissions and data sharing work110### How permissions and data sharing work
85 111