MvgeOS Marketplace

Official marketplace catalog for MvgeOS Runes (extensions) and Mvges (agents).

Overview

The MvgeOS Marketplace hosts official and community-contributed extensions (runes) and concrete agent packages (mvges) for MvgeOS.

Available Mvges (Agents)

Install via MvgeOS CLI:

mvgeos mvge install coding_mvge

Available Runes (Extensions)

Install via MvgeOS CLI:

mvgeos mvge install coding_mvge

Available Runes (Extensions)

Install via MvgeOS CLI:

mvgeos rune install opencode-realm

openrouter-realm is the one a first run needs: the engine’s default model is openrouter/free, and the prefix in that slug is the Realm that must serve it. It needs an OPENROUTER_API_KEY, and no Realm serves a stranger without a credential — see Use another Realm.

Structure

mvgeos-marketplace/
|-- index.json          # single source of truth: what we publish, and what kind
|-- marketplace_index.py # reads index.json; the only place the index is parsed
|-- conftest.py         # pins first-party imports to this checkout (index-driven)
|-- tests/              # index  filesystem  pytest config consistency
|-- mvges/              # agents: installed to ~/.agents/agents/
|   `-- coding_mvge/
|       |-- manifest.json
|       |-- agent.md
|       |-- mvge.py
|       |-- spells/
|       |-- system_prompt/
|       `-- runes/
`-- runes/              # extensions: installed to ~/.agents/extensions/
    |-- openrouter-realm/
    |-- opencode-realm/
    |-- heal-my-goap/
    |-- seeker/
    |-- session-title/
    |-- mcp-bridge/
    |-- opentelemetry-bridge/
    |-- okf-bridge/
    |-- adr-bridge/
    |-- pi-codec/
    |-- skills-bridge/
    |-- steering-bridge/
    `-- skill-evolution/

Runes and mvges are different things

index.json has two sections, and the distinction is real rather than cosmetic:

An mvge never passes through the rune lifecycle and registers no sigils, so it is not “a rune of the mvge type” — it is an agent package. The sections keep them apart, and the consistency tests fail if an artifact carries the other kind’s marker key.

index.json is the only place that fact is recorded. conftest.py derives its sys.path roots and pinned module names from it, so publishing a new artifact cannot leave the test harness silently behind. pyproject.toml has to spell out testpaths and pythonpath literally — TOML cannot call into Python — so tests/test_index_consistency.py asserts those lists still cover every indexed artifact. CI runs bare pytest and so uses testpaths, making a local run and a CI run the same set of tests.

Two layout shapes exist and both are supported: runes/skills-bridge keeps its manifest beside the mvgeos_runes_skills_bridge package, while mvges/coding_mvge is the package with the manifest inside it.

---

License

MIT — same terms as the MvgeOS engine. See LICENSE.