Getting started

Set up Codex

Add the marketplace to make its plugins available. Install the ones you want, whenever you need them.

Compatibility and verification

Compatibility and verification

Verified locally

Local installation and one representative skill were checked on the recorded version. This does not certify every workflow, operating system, or app interface.

Recorded
2026-09-27
Tested with
Codex CLI 0.155.0 on Windows
Supporting documentation
Requirements
  • Install Codex and sign in before running skills. Use the official documentation if the application is not yet available.
  • Check the chosen plugin's requirements; some skills need additional tools or runtimes.
  • Use PowerShell on Windows or Bash/zsh on macOS/Linux. Interactive slash commands are entered inside the application.

Prepare a local copy

Choose one option. These are alternatives; you do not need to do all three.

Use an existing copy

Find the marketplace folder already on your computer. It contains plugins and the hidden .agents/plugins/marketplace.json registry. A plugin folder inside plugins is not the marketplace root.

Keep this copy in a stable location. Do not overwrite it or change its Git branch just to follow this guide.

What you should seeYou know the full path to the marketplace root.

Clone the repository

Git must be installed. Run this from the parent folder where you want to keep the copy. faye-plugin-market is an example destination name; choose another unused name if needed.

If the destination already exists, use that copy or choose a different destination. Do not overwrite it. After cloning, use the full path to the new folder in the next step.

Clone into a new folder · PowerShell
git clone https://github.com/Fayegram-AI/plugin-market.git faye-plugin-market
Clone into a new folder · Bash / zsh
git clone https://github.com/Fayegram-AI/plugin-market.git faye-plugin-market

What you should seeA new local copy exists in the chosen destination.

Download and extract the repository

Open the repository to download a copy

Use its source archive download option, then extract the archive into a stable location. Open the extracted folder containing plugins and .agents/plugins/marketplace.json, not the archive or a surrounding downloads folder.

An extracted archive is a local copy without Git history; git pull cannot update it.

What you should seeThe extracted marketplace root is available on your computer.

Open the marketplace folder

Replace the entire quoted example path below with the full path to your marketplace root. Keep the quotes, especially when the path contains spaces. Choose the command for your terminal shell.

All following relative paths use this folder. The single dot means this marketplace root; ./plugins/<plugin-id> means one plugin folder inside it.

Open your local copy — replace the example path · PowerShell
Set-Location -LiteralPath 'C:\path\to\Faye Plugin Market'
Open your local copy — replace the example path · Bash / zsh
cd -- '/path/to/Faye Plugin Market'

What you should seeYour terminal is in the folder containing plugins and .agents/plugins/marketplace.json.

Add Faye Plugin Market

Run this once for the selected source. If the same source is already registered, reuse it. Adding a marketplace makes its plugins available to choose; it does not install them all.

Run this from the marketplace folder. Open PowerShell or Bash/zsh in your downloaded or cloned marketplace folder, or change to that folder before running this command. It is the folder containing plugins and .agents/plugins/marketplace.json. The dot (.) means your shell’s current folder.

Add marketplace · PowerShell
codex plugin marketplace add .
Add marketplace · Bash / zsh
codex plugin marketplace add .

What you should seeThe source is registered. Its native marketplace identity is faye-plugin-market.

Available plugins

Once the marketplace is added, you can stop here or install any of these plugins. Adding the marketplace does not install every plugin.

Faye Coding Assistantv0.1.0-beta.7Focused, scope-preserving coding skills.

Install Faye Coding Assistant only if you want its skills. Review any permission or trust prompts shown by the application.

Install Faye Coding Assistant · PowerShell
codex plugin add faye-coding-assistant@faye-plugin-market
Install Faye Coding Assistant · Bash / zsh
codex plugin add faye-coding-assistant@faye-plugin-market

What you should seeFaye Coding Assistant appears in the installed plugin list. Compare its version with 0.1.0-beta.7 shown by this marketplace.

Faye Image Utilityv0.1.0-beta.6Image auditing, editing, conversion, and rating estimates.

Install Faye Image Utility only if you want its skills. Review any permission or trust prompts shown by the application.

Install Faye Image Utility · PowerShell
codex plugin add faye-image-utility@faye-plugin-market
Install Faye Image Utility · Bash / zsh
codex plugin add faye-image-utility@faye-plugin-market

What you should seeFaye Image Utility appears in the installed plugin list. Compare its version with 0.1.0-beta.6 shown by this marketplace.

Faye UI System Engineerv0.1.0-beta.4Web UI design, implementation, review, and inspection.

Install Faye UI System Engineer only if you want its skills. Review any permission or trust prompts shown by the application.

Install Faye UI System Engineer · PowerShell
codex plugin add faye-ui-system-engineer@faye-plugin-market
Install Faye UI System Engineer · Bash / zsh
codex plugin add faye-ui-system-engineer@faye-plugin-market

What you should seeFaye UI System Engineer appears in the installed plugin list. Compare its version with 0.1.0-beta.4 shown by this marketplace.

Confirm installation and start a new session

Check the plugins you selected are installed and enabled where the application exposes that state. The list command below is a quick confirmation, not a test of every skill.

Start a new Codex session, open its skill picker or Plugins interface, and choose a task from the installed plugin's skill guides. Read that skill's inputs and requirements before sending your request.

Codex skill requests may use $skill-name. Copy the example from the selected skill's guide, including any explicit invocation it requires.

List installed plugins · PowerShell
codex plugin list --marketplace faye-plugin-market
List installed plugins · Bash / zsh
codex plugin list --marketplace faye-plugin-market

What you should seeYour selected plugins are installed and their applicable skills can be found or explicitly invoked in a fresh session.

Other ways to install

Check an existing installation

Use this before adding a second source or when setup reports that the plugin already exists. Compare the names and source locations; reuse a matching installation.

Installed plugins · PowerShell
codex plugin list --marketplace faye-plugin-market
Installed plugins · Bash / zsh
codex plugin list --marketplace faye-plugin-market
Registered marketplaces · PowerShell
codex plugin marketplace list
Registered marketplaces · Bash / zsh
codex plugin marketplace list

What you should seeThe intended source and installed package are identified without removing other registrations.

Manage later

Update a local copy later

Updating the source is separate from installing a plugin. git pull updates an existing Git checkout; it does not create one and cannot update an extracted archive.

Before updating a checkout, check its branch and local changes. For an archive, obtain a newer copy separately and compare versions. Do not overwrite the existing folder or change an installed plugin without deciding to update it.

What you should seeYou have identified the source and version you intend to use before making an update.

Enable or disable a plugin

Open /plugins inside Codex. Select an installed plugin and use the displayed enable/disable action. Disabling keeps the installation but makes its capabilities unavailable until enabled again.

Inside Codex
/plugins

What you should seeThe plugin browser shows the intended enabled state.

Uninstall Faye Coding Assistant

Only use this when you intend to remove this plugin. It removes the selected installation and its capabilities; it is not a troubleshooting prerequisite. Leave other plugins and marketplace sources intact.

Uninstall selected plugin · PowerShell
codex plugin remove faye-coding-assistant@faye-plugin-market
Uninstall selected plugin · Bash / zsh
codex plugin remove faye-coding-assistant@faye-plugin-market

What you should seeFaye Coding Assistant is no longer listed as installed.

Uninstall Faye Image Utility

Only use this when you intend to remove this plugin. It removes the selected installation and its capabilities; it is not a troubleshooting prerequisite. Leave other plugins and marketplace sources intact.

Uninstall selected plugin · PowerShell
codex plugin remove faye-image-utility@faye-plugin-market
Uninstall selected plugin · Bash / zsh
codex plugin remove faye-image-utility@faye-plugin-market

What you should seeFaye Image Utility is no longer listed as installed.

Uninstall Faye UI System Engineer

Only use this when you intend to remove this plugin. It removes the selected installation and its capabilities; it is not a troubleshooting prerequisite. Leave other plugins and marketplace sources intact.

Uninstall selected plugin · PowerShell
codex plugin remove faye-ui-system-engineer@faye-plugin-market
Uninstall selected plugin · Bash / zsh
codex plugin remove faye-ui-system-engineer@faye-plugin-market

What you should seeFaye UI System Engineer is no longer listed as installed.

Open original image