PepeHubregistry

Como publicar no PepeHub

1. Login

A CLI do Pepe autentica via GitHub Device Flow, o mesmo modelo do gh auth login:

  1. Rodar pepe skill publish (ou pepe plugin publish) chama POST /api/v1/auth/device/start, que devolve um código de 8 caracteres e um link.
  2. Abrir o link, colar o código e aprovar com sua conta do GitHub.
  3. A CLI recebe um token de sessão do PepeHub assim que você aprova, e usa esse token em todo publish seguinte.

2. Formato aceito

O artefato enviado é um tarball (.tgz) pra plugins ou umzip (.zip) pra skills, junto de um manifesto JSON com pelo menoskind, version (semver) e category (uma das categorias fixas do PepeHub).

O formato completo do manifesto, a estrutura interna do pacote, como declarar comandos, hooks etc., é documentado no site do Pepe, não aqui, pra não duplicar conteúdo: skills eplugins.

3. Publicar

pepe skill publish

O namespace do pacote (@seu-handle/nome) precisa começar com o seu handle do GitHub: a primeira publicação de um nome cria o pacote automaticamente.

4. Prefere não usar a CLI?

Dá pra publicar direto pelo navegador também, enviando o arquivo (.zip ou .tgz) num formulário: publicar pelo navegador.