Telvine Learn

How to Add a Plugin Marketplace to Codex

Install the Altrym GitHub plugin marketplace in Codex so you can use Telvine Plugin Builder and keep plugin tooling updated from Git.

Codex can install plugins from a GitHub repo, Git URL, or local folder. Use a Git marketplace when you want the plugin to stay tied to a source repo instead of passing around zip files.

The GitHub browser page for the marketplace is:

https://github.com/Altrym/example-plugin-marketplace/tree/main

Do not paste a /tree/main/... GitHub page into the Source field. Codex clones the Source as a Git remote, so Source must be the repo root.

Add the Telvine marketplace

Open Add marketplace in Codex and enter:

FieldValue
Sourcehttps://github.com/Altrym/example-plugin-marketplace.git
Git refmain
Sparse paths.agents/plugins and plugins

Then install Telvine Plugin Builder from the marketplace.

The plugin lives at:

plugins/telvine-plugin-builder

Which Git ref should you use?

Use main when you want the latest marketplace version. Use a release tag when you want a pinned, stable version.

When Telvine publishes a new plugin version to the Git ref you installed from, Codex can pick up that newer marketplace state when the marketplace is refreshed or reinstalled. It may not update an already-running agent session immediately.

Why Git instead of zip?

Git is better for distribution because users can see the source, pin a ref, and update from the same marketplace later. A zip or local folder is useful for quick testing, but it is harder to keep a team on the same version.

Next steps

On this page