Marketplaces

Encontre plugins em um catálogo, confira o que fazem ou publique seu próprio catálogo.

Explore o marketplace oficial e instale um plugin

Digite /extensions e pressione m para abrir Plugins. O Clarvis carrega automaticamente o catálogo oficial getclarvis/marketplace; você não precisa adicionar a URL dele às configurações.

1. Mova para a esquerda e direita entre Todos, Instalados, cada marketplace exato, Workspace e Adicionar marketplace. Use cima e baixo na coleção selecionada.
2. Pressione / para pesquisar apenas nessa coleção ou g para instalar diretamente por URL Git. Pressione Enter em Adicionar marketplace para registrar outro catálogo.
3. Pressione Enter em um plugin para inspecionar sua origem exata, estado no Extension Profile, agentes, skills, servidores MCP, hooks, serviços e comandos executáveis.
4. Pressione Enter novamente em uma listagem disponível para instalar e ativar o plugin completo no Extension Profile atual. O lado direito do rodapé mostra a operação animada e o tempo decorrido.

Etapa 1 — coleção. Escolha o catálogo exato ou o inventário instalado que deseja explorar.

Etapa 2 — pesquisa. O filtro com barra vale somente para a coleção selecionada.

Etapa 3 — revisão. Inspecione identidade, origem, publisher, política e a superfície completa de capacidades antes de instalar.

Etapa 4 — ativação. O estado final identifica a instalação gerenciada e o Extension Profile que a selecionou.

Uma listagem é apenas um ponteiro para um repositório de origem: apenas aparecer no catálogo não instala nem ativa nada. Escolher instalar e ativar é o limite explícito de consentimento para o plugin completo, incluindo hooks e outras contribuições executáveis. Plugins instalados continuam visíveis em Instalados mesmo quando outro Extension Profile os deixa inativos.

Somente uma instalação Git global gerenciada oferece Atualizar. Instalações locais ou npm, checkouts não gerenciados ou vinculados e plugins do workspace continuam visíveis, mas precisam ser atualizados na origem que os possui.

O editor guiado continua disponível em /extensions: pressione Enter, escolha o escopo e o Extension Profile e adicione ou remova plugins instalados exatos e skills independentes. Escape sempre volta um nível. Se o rascunho tiver mudanças, o Clarvis confirma antes de descartá-las.

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": {
        "source": "url",
        "url": "https://github.com/acme/quality-kit.git",
        "ref": "v1.2.3"
      },
      "description": "Agentes, skills e verificações voltados à revisão.",
      "displayName": "Quality Kit",
      "homepage": "https://github.com/acme/quality-kit",
      "category": "Quality",
      "policy": {
        "installation": "AVAILABLE",
        "authentication": "ON_FIRST_USE"
      }
    },
    {
      "name": "repo-tools",
      "source": {
        "source": "git-subdir",
        "url": "https://github.com/acme/clarvis-plugins.git",
        "path": "plugins/repo-tools",
        "ref": "main"
      },
      "description": "Auxiliares para manutenção de repositórios."
    },
    {
      "name": "formatter-kit",
      "source": {
        "source": "npm",
        "package": "@acme/formatter-kit",
        "version": "1.0.0"
      },
      "description": "Auxiliares de formatação distribuídos pelo npm."
    }
  ]
}

Cada listagem utilizável precisa de name e source. O nome da listagem é a identidade esperada da instalação: um plugin com nome explícito precisa coincidir com ele, enquanto um manifesto estrangeiro compatível sem nome recebe o nome da listagem. Uma divergência é recusada, em vez de ser instalada com namespace ambíguo.

O Clarvis aceita estas formas instaláveis de origem:

• uma URL Git em string, incluindo HTTPS, SSH e SSH no estilo scp;
• { "source": "url", "url": "…", "ref": "…" }, podendo substituir ref por um sha de commit completo;
• { "source": "git-subdir", "url": "…", "path": "…" }, com caminho relativo confinado e, opcionalmente, um ref ou sha;
• { "source": "local", "path": "plugins/example" }, confinada ao diretório do marketplace;
• { "source": "npm", "package": "@scope/name", "version": "…", "registry": "…" }, com versão e registry opcionais; um registry personalizado precisa ser HTTPS e não conter credenciais.

Origens locais são copiadas para o inventário gerenciado sob limites de arquivos, quantidade e profundidade; symlinks e entradas especiais do sistema de arquivos são recusados. Em um marketplace Git remoto, uma origem local confinada é projetada de volta para esse repositório e subdiretório antes da remoção do checkout temporário do catálogo. A aquisição via npm desabilita scripts de ciclo de vida, auditorias e pedidos de financiamento. Use uma origem Git remota ou npm em um marketplace destinado a funcionar fora do próprio checkout.

policy.installation aceita AVAILABLE, INSTALLED_BY_DEFAULT e NOT_AVAILABLE; policy.authentication aceita ON_INSTALL e ON_FIRST_USE. São políticas de apresentação do catálogo, não autoridade: carregar um marketplace nunca instala, ativa ou autentica um plugin, e NOT_AVAILABLE suprime a ação de instalação. displayName, description, homepage, category e os dados limitados de interface são apenas campos de apresentação.

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.

Para contribuir com um plugin para o catálogo oficial, siga o processo de contribuição em getclarvis/marketplace. O repositório oficial registra os metadados de revisão e a revisão upstream exata inspecionada para cada entrada aceita. O código do plugin permanece no repositório upstream; path identifica um subdiretório apenas quando necessário.

Configure manualmente um marketplace adicional

O marketplace oficial é integrado ao Clarvis e não é gravado nas configurações. A TUI grava as URLs dos marketplaces adicionais 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. Quando a superfície protegida muda, o Clarvis pede na entrada a aprovação do fingerprint exato. /workspace-trust continua disponível depois para revisão ou revogação.

Veja também

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