Como publicar no PepeHub

1. Sessão

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

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

2. Formato aceite

O artefacto enviado é um tarball (.tgz) para plugins ou um zip (.zip) para skills, junto de um manifesto JSON com pelo menos kind, version (semver) e category (uma das categorias fixas do PepeHub).

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

3. Publicar

pepe skill publish

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

4. Prefere não usar a CLI?

Também é possível publicar diretamente pelo navegador, enviando o ficheiro (.zip ou .tgz) num formulário: publicar pelo navegador.