Marketplace

The Marketplace lists agents that people published as public GitHub repos. Importing one copies the repo to your computer and adds each agent it declares to your Agents list, where you can change its settings. CatalEx does not verify these repos, so read the code on GitHub before you import. To publish your own, see the setup file guide.

You need to be signed in to CatalEx. Importing runs on this computer and needs Git installed.

In the app

Browse and search

1. Choose Marketplace in the sidebar.
2. Each card shows the agent's name, its GitHub repo (a link), a two-line description, GitHub stars and forks (each opens its GitHub page), the number of Installs on CatalEx, and one action.
3. Type in Search to filter by name, repo or description. Use Sort by to order the cards by Default, Installs, Stars or Forks. Default puts your own listings first, then the most installed.
4. Hover the info icon next to the title to read the reminder that CatalEx does not verify these repos.

If the page cannot load, it shows The Marketplace is unavailable with Retry. With no listings it shows No repos yet, or No repos match your search.

Import an agent

1. On a card, choose Import.
2. Confirm. A repo with one agent asks Import NAME? A repo with several asks Import agents? and lists the agents it sets up. Choose Import.
3. Wait for the card to change to Imported. The agents appear on the Agents page, in a folder named after the repo under ~/catalex, with the settings the repo suggests. Open an agent's Settings to change them.

CatalEx uses the AI tool the repo asks for when this computer has it, and otherwise your default. A failed import leaves no folder or agents behind.

Update an imported agent

When the repo has a newer version, its card shows Update (hover: New updates available) and the agent's tile on the Agents page shows an update icon. Choose either, then confirm Update NAME? ("This will do a fresh install of the agent. Are you sure?").

An update clones the new version into a new folder and moves the agents there. Their chats, channels and your own settings stay. Nothing is copied from the old folder, which is never deleted, so keep data that must survive an update outside the agent folder.

A card that says Unavailable is your own listing whose repo went private or away.

Add your own repo

1. Choose Add a repo.
2. Paste the link to a public GitHub repo, for example https://github.com/OWNER/REPO (your GitHub user or organization and the repo name).
3. Choose Import. CatalEx lists the repo for everyone on CatalEx, shows NAME is added and then imports its agents on this computer, with the same confirmation as above. If the repo is already listed, it is imported from its listing.

If the import fails after the listing is added, the dialog says the repo is on the Marketplace but its agents were not imported, and why. The listing stays.

Fix or remove your listing

• A listing you added shows a warning icon (Setup has some issues) when its catalex.yaml has problems. Choose it to read each problem and a link to the setup file guide. CatalEx used defaults for the invalid settings. Fix the file and push; the next daily refresh picks it up. Only you see this.
• Choose the bin icon (Remove) and confirm to take your listing off the Marketplace. Agents people already imported keep working. The repo may be listed again later, but its install count starts again at zero.

CatalEx refreshes stars, forks, description and the offered version of every listing about once a day.

With the CLI

Every catalex marketplace command needs a CatalEx sign-in on this device. LISTING is a listing ID or OWNER/REPO, in any letter case.

Command	What it does
catalex marketplace list [--search TEXT] [--sort default|installs|stars|forks]	Lists listings with installs, stars and forks. The state column is Import, Imported, Update or Unavailable, as on the cards.
catalex marketplace add GITHUB_URL [--yes]	Adds a public https://github.com/OWNER/REPO, then imports it. A repo already listed is imported as it is. Declining the import keeps the listing.
catalex marketplace import LISTING [--yes]	Asks Import NAME? or Import agents?, clones the offered version into ~/catalex/REPO (or REPO-2, REPO-3) and prints the agents it added. If this computer already holds the listing, it asks the update question instead.
catalex marketplace update LISTING [--yes]	Asks Update NAME? and moves the agents to a fresh clone; the old folder stays. A listing you never imported exits 5 with LISTING_NOT_IMPORTED.
catalex marketplace remove LISTING [--yes]	Asks Remove NAME? and takes your listing off the Marketplace. Another account's listing exits 4 with LISTING_NOT_YOURS.
catalex marketplace issues LISTING	Prints the problems found in your repo's catalex.yaml and the setup file guide.

Without a terminal, a command that asks needs --yes; otherwise it exits 2 with CONFIRMATION_REQUIRED and changes nothing. Add --json for machine-readable output. Example:

catalex marketplace list --search support --sort installs
catalex marketplace import OWNER/REPO

Common refusals, each with a next action in its output:

Code	What to do
LISTING_URL_INVALID	Give a public https://github.com/OWNER/REPO address.
LISTING_REPO_NOT_FOUND	Make the repo public or correct the address.
GIT_UNAVAILABLE	Install Git, then try again.
NO_PROVIDER	Set up Claude Code or Codex first; see AI tools.
IMPORT_TOO_LARGE	The repo is over 500 MiB; there is nothing to retry.
GITHUB_UNAVAILABLE, IMPORT_CLONE_FAILED, IMPORT_IN_PROGRESS, LISTING_RATE_LIMITED	Run the command again in a moment.

Marketplace commands run on this computer only; with --computer they exit 2 with NOT_REMOTE.

Limits

• CatalEx imports at most 100 Marketplace agents onto one computer at a time.
• Importing never runs anything from the repo: no git hooks, install scripts or submodules. The code runs only when someone talks to the agent, under the tool settings you approve.
• The agent's folder holds the whole repo, so instructions can refer to any file in it.