Marketplaces

Publique e explore listagens selecionadas de plugins sem tratar um catálogo como permissão para executar código.

Adicione um marketplace e instale um plugin

Digite /extensions/market e siga a sequência completa de ativação:

1. Pressione a e insira a URL Git do repositório do marketplace.
2. Selecione uma listagem e pressione Enter para instalá-la.
3. O Clarvis abre a tela Plugins. Selecione o plugin instalado e pressione e para habilitá-lo.
4. Se ele fornecer hooks, abra /extensions/hooks, inspecione cada definição exata e pressione t para aprovar as que você aceitar.

Pressione r no navegador de marketplaces para buscar novamente os catálogos configurados. Uma listagem é apenas um ponteiro para um repositório de origem: aparecer em um marketplace não concede confiança, não habilita nada e não aprova nenhum hook.

Comportamento da TUI local

A navegação em marketplaces executa o Git na máquina que exibe a TUI. Use esse fluxo com a TUI local do Clarvis. Um host remoto futuro poderá separar a máquina de exibição da máquina que instala os plugins.

Publique um marketplace

Crie um repositório Git com marketplace.json na raiz:

{
  "name": "acme-extensions",
  "displayName": "Acme Extensions",
  "description": "Plugins do Clarvis revisados para projetos da Acme.",
  "plugins": [
    {
      "name": "quality-kit",
      "source": "https://github.com/acme/quality-kit.git",
      "description": "Agentes, skills e verificações voltados à revisão.",
      "displayName": "Quality Kit",
      "homepage": "https://github.com/acme/quality-kit",
      "category": "Quality"
    },
    {
      "name": "repo-tools",
      "source": "https://github.com/acme/clarvis-plugins.git",
      "path": "plugins/repo-tools",
      "description": "Auxiliares para manutenção de repositórios."
    }
  ]
}

Cada listagem utilizável precisa de name e source. Use path quando o plugin ocupar um subdiretório do repositório de origem. Ele precisa ser um caminho relativo que permaneça dentro desse repositório. displayName, description, homepage e category são campos de apresentação.

Origens HTTPS, SSH e SSH no estilo scp podem ser instaladas pelo navegador. Uma origem local relativa pode ser exibida para compatibilidade, mas o Clarvis não oferece uma ação de instalação para ela. Use uma origem Git remota em um marketplace destinado a outros usuários.

Assim como os manifestos de plugins, os documentos de marketplace são lidos de forma tolerante. Campos desconhecidos e problemas de apresentação recuperáveis são relatados como observações, em vez de serem ignorados silenciosamente. Listagens sem um name ou source utilizável são descartadas.

Configure um marketplace manualmente

A TUI grava as URLs de marketplaces nas suas configurações globais. Você também pode editar ~/.clarvis/settings.json:

{
  "marketplaces": ["https://github.com/acme/clarvis-marketplace.git"]
}

Um workspace pode declarar sua própria lista marketplaces em .clarvis/settings.json. O Clarvis retém essa lista até que você aprove o repositório com /workspace-trust.

Veja também

• Plugins
• Hooks
• Referência de extensões