VibeVM
Contents
On this page
en
Publisher
org.vibevm.core
Version
1.0.0latest
Audiences
user, author
Reading time
2 min
Rendered
Read aloud
never

Publish a package to the central registry

01Every VibeVM project can install packages from two public places: the organisation vibespecs on GitHub and the organisation of the same name on GitVerse. Only their administrators can add a package there, so to publish yours, you ask them. This page shows how to ask, and what can keep a package out.

02
Check that the in-tree package org.acme/review-notes of this project, the slot vibevm/vibepacks/org.acme/review-notes/v0.1.0, is ready for the central registry, then write the message that asks to add it, for the Add package topic of the VibeVM chat. The platform is GitHub; my username there is octocat. Send nothing.

the vibevm skill installed for your agent; no network

the agent names anything the package still lacks, such as an empty description, and shows a short message with the package's group and name, the platform and your username, ready to paste into Telegram

  • vibe validate

What happens

03The agent reads the package's manifest and checks what a stranger who installs it will see: the group and the name, the version, the license and a one-line description. It runs vibe validate to make sure the project around the package is sound. Then it writes a message of three lines: the package's group and name, the platform, and your username there. The agent sends nothing. You paste the message into the topic yourself, because the request is yours, and so is the account.

By hand

041. Open the Add package topic of the VibeVM chat in Telegram: t.me/vibevm_chat/9.

052. Name the package: its group and its name, such as org.acme/review-notes.

063. Name the platform where the package should live: GitHub or GitVerse. If you name none, it is GitHub.

074. Give your username on that platform, as the package's maintainer.

08Once that account can write to the package's repository, you publish its versions yourself, as Publish a package shows.

The central registry

09A registry in VibeVM is a hosting organisation where every package is its own git repository. The central one is the pair that every machine trusts by default: https://github.com/vibespecs and https://gitverse.ru/vibespecs. The first time vibe runs, it writes both into the list of registries it keeps for the whole machine, so every project installs from them without setup.

10 spec: The default trust set is exactly two roots
The default trust set is exactly two roots — https://github.com/vibespecs and https://gitverse.ru/vibespecs — trusted by default as the registries vibe init writes. Every other registry is trusted only by the user's own act of adding it to their configuration (owner ruling, 2026-08-13).

Names that can be refused

11The names of a package, its group and its own name, can be covered by someone's copyright, or be barred from publication for another reason. Such a package can be refused, or removed after it was published.

What the administration may do

12The administration of the central registry reserves the right to refuse any package, to delete any package from it, and to take other administrative actions with any package. These actions must not contradict the law. Which law applies is described on Applicable law.

Edge cases and rules

13If you need a place you control, or a private one, publish to a registry of your own, as Publish a package shows. Nobody has to approve a package there.

For an agent

This page has a machine mirror. The citation carries the version rather than latest, so what an agent quotes does not move under it.

spec://org.vibevm.core/vibevm-docs@1.0.0/howto/publish-to-the-central-registry

.md.xmlllms.txt