Extension Profiles
Crie conjuntos separados de extensões para pesquisa, programação, revisão ou qualquer outro tipo de trabalho.
Um Extension Profile é um conjunto de plugins instalados e skills independentes que você salva com um nome. Você escolhe o que cada perfil inclui. Por exemplo:
- Pesquisa: somente extensões para navegar, consultar documentação e trabalhar com fontes.
- Código: plugins e skills para implementar mudanças e escrever testes.
- Revisão: um conjunto separado para revisar alterações antes de entregá-las.
Esses são exemplos que você pode criar, não perfis prontos. Um perfil próprio carrega apenas as extensões que você selecionou, sem receber extensões de outros perfis.
O perfil não precisa estar vinculado a um projeto. Você pode alternar de pesquisa para programação no mesmo workspace ou usar um perfil global em vários workspaces. Também pode salvar um perfil dentro do workspace quando quiser manter sua definição junto do projeto.
O perfil escolhe as extensões, não o agente ou modelo ativo. Perfis de agente, permissões, regras do sandbox, credenciais e versões dos plugins são configurados separadamente.
No editor guiado de /extensions, você pode instalar um plugin enquanto prepara um perfil. Ele só será ativado quando você revisar e aplicar o conjunto completo. O navegador de Plugins também oferece uma ação explícita para instalar e ativar de uma vez.
Use menos tokens de entrada
As definições de ferramentas ocupam espaço no contexto do modelo. Ao deixar um plugin fora do perfil, você também deixa de enviar suas ferramentas, incluindo as oferecidas pelos servidores MCP desse plugin. Um conjunto menor envia menos definições ao modelo, reduzindo tokens de entrada e podendo diminuir o custo por uso.
O perfil também limita quais skills aparecem no catálogo apresentado ao modelo. O Clarvis normalmente lista primeiro os nomes e as descrições, sem carregar as instruções completas de todas as skills no prompt.
Não há uma economia fixa: o custo final também depende do modelo, do cache de prompts e do restante da conversa. As ferramentas nativas do Clarvis e os MCPs configurados separadamente dos plugins continuam seguindo suas próprias configurações.
Comece pelo padrão builtin
builtin:default é o perfil integrado. Ele não pode ser editado diretamente:
enabledPluginsseleciona instalações exatas de plugins por{ scope, source, name };- plugins habilitados fornecem todos os seus agentes, skills, servidores MCP, serviços de capacidade e hooks;
- as ferramentas anunciadas por esses servidores MCP ficam disponíveis para todos os agentes efetivos nas próximas execuções, sem editar o perfil de agente salvo;
- as quatro raízes de skills independentes ficam disponíveis com a precedência existente.
Crie um perfil próprio para escolher uma lista independente da seleção do perfil integrado.
Componha e selecione na TUI
Abra /extensions e pressione Enter. O Clarvis conduz a mudança completa em cinco decisões:
- escolha se o perfil será usado neste workspace ou como padrão global;
- edite um perfil existente, copie o perfil ativo ou comece um perfil vazio;
- escolha plugins e skills, buscando entre os itens instalados e o marketplace;
- confira tudo que a seleção oferece: agentes, skills, ferramentas MCP, hooks e outros serviços;
- revise o que será ativado ou removido, aprove a configuração do workspace se necessário e aplique.
A etapa 3 mantém o rascunho em memória. Enter adiciona ou remove um plugin instalado ou uma skill standalone; em uma listagem do marketplace, primeiro pergunta por .agents/plugins ou .clarvis/plugins, instala o plugin e prepara a instalação exata retornada. A instalação é imediata, mas nada fica ativo antes da etapa 5. Escape volta um nível; se o rascunho mudou, o Clarvis confirma antes de descartá-lo.
Ao aplicar, o Clarvis salva o perfil e sua seleção juntos. Se os arquivos do perfil, da seleção ou das extensões mudarem desde a revisão, você precisará revisar uma nova prévia.
A mudança reconecta o backend e vale para novas execuções. Uma execução em andamento mantém o conjunto com que começou. Os hooks de um plugin são ativados ou removidos junto com ele.
O rodapé mostra a operação em andamento e o tempo decorrido durante a instalação, a revisão dos recursos, a aplicação e a reconexão. Ele não mostra porcentagens estimadas. Aguarde a conclusão antes de continuar a edição.
A partir de /extensions, pressione e para abrir o navegador de diagnóstico e seleção. Ele mostra o Extension Profile ativo, fingerprint, origem da seleção, contagens de itens instalados e ativos, cada contribuição resolvida e qualquer problema. Pressione / para pesquisar definições e Enter para abrir o snapshot selecionado em detalhes roláveis.
| Tecla | Ação |
|---|---|
w | Mostra as alterações e usa o Extension Profile selecionado apenas neste workspace. |
g | Mostra as alterações e torna uma seleção global ou builtin o padrão global. |
n | Inicia o editor guiado para um novo Extension Profile. |
e | Configura a definição selecionada ou personaliza um clone de builtin:default. |
x | Limpa a seleção local deste workspace e mostra qual perfil será usado no lugar. |
d | Exclui o Extension Profile personalizado inativo selecionado após confirmação. |
r | Atualiza definições e diagnósticos. |
O preview de seleção do navegador avançado lista cada plugin, skill, servidor MCP e hook que entra ou sai, enquanto o rodapé mantém y para aplicar e n para cancelar visíveis. Nenhuma seleção muda antes de y.
As prévias usam a mesma precedência da ativação. Se uma seleção do workspace já tiver prioridade sobre o padrão global, alterar esse padrão global pré-visualiza o mesmo Extension Profile efetivo, sem mudar o conjunto ativo. Uma prévia fica vinculada aos dois documentos de seleção; se qualquer um deles mudar antes da confirmação, o Clarvis exige uma nova prévia.
Use o editor guiado para adicionar ou remover plugins e skills independentes. Um plugin é selecionado como um conjunto: seus agentes, skills, servidores MCP, hooks e serviços são ativados ou removidos juntos.
Crie uma lista completa de extensões
O perfil contém a lista completa do que pode ser carregado, também chamada de allow-list.
Definições globais ficam em ~/.clarvis/extension-profiles/<nome>.json. Definições de workspace ficam em <workspace>/.clarvis/extension-profiles/<nome>.json e podem ser versionadas no repositório.
{
"schema_version": 1,
"description": "Pesquisa com navegador e documentação",
"plugins": [
{ "scope": "global", "source": "agents", "name": "browser" },
{ "scope": "global", "source": "clarvis", "name": "github" }
],
"skills": [{ "scope": "user", "source": "clarvis", "name": "deep-research" }]
}plugins e skills são listas completas, não acréscimos a builtin:default. Referências de plugins qualificam escopo (global ou workspace) e origem (agents para .agents/plugins, clarvis para .clarvis/plugins); outra instalação de mesmo nome nunca é substituída. Referências de skills independentes qualificam tanto o escopo (user ou workspace) quanto a origem (agents ou clarvis). Um Extension Profile global pode referenciar apenas plugins globais e skills de usuário. Um Extension Profile de workspace pode combinar os quatro inventários de plugins.
Definições não herdam. Clone um Extension Profile quando quiser uma variação.
Entenda a seleção e o compartilhamento
O Clarvis resolve o Extension Profile ativo nesta ordem:
--extension-profilepara este processo;- a seleção local deste workspace;
- a seleção global padrão;
builtin:default.
Use um seletor qualificado quando o escopo importar:
clarvis --extension-profile global:research
clarvis --extension-profile workspace:project -p "Revise esta alteração"Um nome sem escopo procura primeiro a definição de workspace e depois a global. --extension-profile não persiste uma escolha, e o processo em execução não pode sobrescrever sua seleção local ou global enquanto o override estiver ativo.
Definições de workspace são compartilháveis, mas a escolha ativa é sempre local à máquina, no estado do Clarvis. Clonar um repositório, portanto, não ativa seu Extension Profile sozinho.
Diagnostique confiança e divergências
Um Extension Profile fica ready, degraded ou invalid:
- um plugin ou uma skill independente ausente fica
degradede permanece visivelmente inativo; - uma definição ou seleção inválida fica
invalide nunca cai para um padrão mais amplo; - um Extension Profile que selecione um plugin ainda não aprovado pertencente ao repositório fica
degraded, enquanto plugins globais selecionados continuam ativos.
Ao iniciar, o Clarvis verifica o conteúdo de todos os plugins instalados no workspace, selecionados ou não pelo perfil atual. Uma aprovação cobre esse conjunto exato ao trocar de perfil. Alterar arquivos incluídos na verificação ou suas permissões de execução exige nova revisão; editar apenas a lista do perfil não muda essa aprovação.
Plugins globais não precisam de uma segunda aprovação do workspace. Se você recusar a aprovação, o Clarvis abre Extensions para remover itens indesejados. Use /workspace-trust depois para revisar ou revogar a confiança.
O Clarvis recusa aprovar ou revogar a confiança no workspace enquanto uma execução estiver ativa, antes de alterar o registro de confiança. Quando não há execução ativa, essa decisão faz o Clarvis recompor o Extension Profile de workspace selecionado, ou as partes de builtin:default derivadas do workspace, antes da próxima execução.
Cada execução mantém uma cópia fixa da seleção de extensões, chamada de snapshot. Um identificador de conteúdo, o fingerprint, registra os manifestos, declarações MCP e de hooks, origem e revisão da instalação, arquivos de agentes, instruções e recursos das skills selecionadas e a aprovação de confiança.
Se algum desses arquivos mudar, o Clarvis bloqueia novos acessos às extensões até você usar /reconnect. A execução não passa a usar conteúdo alterado sem uma nova verificação. O histórico das execuções, os registros de diagnóstico e as sessões guardam o ID e o fingerprint do perfil. Ao retomar uma sessão com outro fingerprint, você verá um aviso.