Private plugin marketplace for qlax agent tooling. The first plugin is vctl, a Vendure admin API skill and Python CLI used for marketplace operations.

After this repository exists on Forgejo, add it as a marketplace:

codex plugin marketplace add https://git.qlax.de/qlax/agent-plugins.git --ref main

Codex accepts HTTPS Git URLs, SSH Git URLs, GitHub shorthand, and local marketplace roots. The canonical Codex marketplace manifest in this repo is:

.agents/plugins/marketplace.json

Codex resolves plugin paths relative to the marketplace root, so the vctl entry points to ./plugins/vctl.

1. Install Git for Windows and make sure git clone https://git.qlax.de/qlax/agent-plugins.git works.
2. Install Python 3 and confirm py --version works in PowerShell.
3. Add the marketplace with the codex plugin marketplace add command above.
4. Install and enable the vctl plugin in Codex.
5. Configure a vctl profile:

py .\plugins\vctl\skills\remote-vendure-access\scripts\vctl configure staging
py .\plugins\vctl\skills\remote-vendure-access\scripts\vctl staging whoami

Codex may clone the marketplace into its own plugin cache after installation. When working inside that cache, use the same skills\remote-vendure-access\scripts\vctl path inside the installed plugin root.

Use the normal Forgejo HTTPS credential helper or SSH setup approved for qlax. Do not put Forgejo tokens into this repository or into local .env files. Tokens live in Infisical.

The repo also includes a Claude/Cowork-shaped marketplace manifest at:

.claude-plugin/marketplace.json

Forgejo marketplace URL support in Cowork still needs the manual 15-minute check from the handoff. If Cowork rejects Forgejo URLs, mirror this repository to a private GitHub repository and add that Git URL to Cowork instead.

plugins/
  vctl/
    .codex-plugin/plugin.json
    .claude-plugin/plugin.json
    skills/remote-vendure-access/