Extensões
Adicione ferramentas, instruções reutilizáveis e automações. Organize-as em perfis para diferentes tipos de trabalho.
Extensões acrescentam ferramentas, instruções e automações ao Clarvis. Um Extension Profile reúne os plugins e as skills que você quer usar juntos: um conjunto só para pesquisa, outro para programação, outro para revisão. Você pode criar perfis para outras finalidades e alternar entre eles no mesmo projeto.
No editor guiado, instalar um plugin e ativá-lo são etapas separadas. Você revisa o conjunto completo antes de aplicar. O navegador de Plugins também oferece uma ação explícita para instalar e ativar de uma vez.
Entenda as quatro camadas
| Camada | O que faz |
|---|---|
| Marketplace | Catálogo que ajuda a descobrir pacotes de plugins. Não ativa nada. |
| Plugin | Pacote instalado que pode fornecer agentes, skills, servidores MCP, hooks ou backends de capacidades. |
| Skill independente | Pacote de instruções reutilizáveis instalado independentemente de um plugin. |
| Extension Profile | Lista completa de plugins instalados e skills independentes que serão usados. |
Um plugin é selecionado como um conjunto: todos os recursos que ele declara entram juntos. Uma skill independente pode ser selecionada sozinha. O Extension Profile não altera modelos, agentes, permissões ou sandbox, não guarda credenciais e não fixa versões de pacotes.
Acompanhe o fluxo de ativação
Abra /extensions e pressione Enter para usar o editor guiado:
- escolha se a definição pertence ao escopo global ou a este workspace;
- edite um perfil, copie a seleção atual ou comece uma lista vazia;
- pesquise listagens do marketplace, plugins instalados e skills independentes juntos;
- inspecione o conjunto completo de agentes, skills, MCP, hooks e executáveis;
- revise o que será ativado ou removido, aprove conteúdo executável do workspace quando necessário, aplique e reconecte.
A instalação iniciada em uma linha do marketplace acontece antes da ativação. O item é apenas preparado no rascunho; nada fica ativo antes da aprovação das mudanças finais. Uma aplicação bem-sucedida vale para novas execuções. Uma execução em andamento mantém o snapshot imutável com que começou.
Escolha o padrão ou um perfil isolado
builtin:default é o perfil integrado, que não pode ser editado diretamente. Ele usa a lista padrão de plugins ativados e os diretórios padrão de skills, respeitando sua ordem de prioridade.
Crie um Extension Profile para manter conjuntos separados de extensões conforme a finalidade. Por exemplo, seu perfil de pesquisa pode incluir só extensões de navegador e documentação, deixando as de programação em outro perfil. Perfis globais podem ser reutilizados em vários workspaces.
Cada perfil próprio contém sua lista completa de extensões: não recebe itens de builtin:default nem herda de outro perfil.
Deixar plugins desnecessários fora do perfil também deixa suas definições de ferramentas fora do contexto do modelo. Isso reduz tokens de entrada e pode diminuir o custo por uso. Veja como os perfis afetam o uso de tokens.
Mantenha a ativação local e auditável
As definições podem ter escopo global ou do workspace. Uma definição de workspace pode ser versionada e compartilhada, mas o perfil selecionado é estado local da máquina: clonar um repositório não ativa conteúdo executável sozinho.
Plugins do workspace precisam ser aprovados antes do uso. O Clarvis verifica seu conteúdo e registra um identificador, chamado fingerprint. Se o conteúdo selecionado mudar, novos acessos são bloqueados. Use /reconnect após uma mudança intencional para carregar e verificar a nova versão.
Escolha o guia de extensões certo
| Você quer… | Leia |
|---|---|
| escolher um conjunto de plugins e skills | Extension Profiles |
| dar aos agentes instruções reutilizáveis sob demanda | Skills |
| conectar um servidor externo de ferramentas ou prompts | Servidores MCP |
| executar automações em eventos do ciclo de vida | Hooks |
| empacotar várias contribuições juntas | Plugins |
| publicar ou consumir catálogos de plugins | Marketplaces |
| inspecionar formatos, limites e estados | Referência de extensões |
| entender escopo e aprovação de executáveis | Escopos e confiança no workspace |