Dex

Dex gerencia fontes públicas de skills hospedadas no GitHub e compõe os catálogos habilitados em cada workspace pelo Visual Studio Code ou pelo Kiro.

Como usar

1. Abra uma pasta ou workspace confiável.
2. No Explorer, localize a seção Fontes de skills Dex.
3. Use o botão + para cadastrar uma fonte ou, no menu de três pontos, escolha Dex: Adicionar fonte Dex padrão.
4. Use o botão de sincronização no cabeçalho para atualizar todas as fontes habilitadas.

A extensão identifica o editor automaticamente e grava a composição em:

• Visual Studio Code: .agents/skills;
• Kiro: .kiro/skills.

É necessário ter acesso à internet durante a sincronização e a verificação de atualizações.

Configuração por workspace

As fontes ficam declaradas em .dex/sync.json na raiz selecionada. Abrir uma pasta sem esse arquivo não cria configuração, adiciona fontes, consulta o GitHub ou sincroniza skills automaticamente. O arquivo é criado somente quando uma fonte é adicionada pela extensão.

Exemplo de configuração:

{
  "version": 1,
  "sources": [
    {
      "id": "dex-ai",
      "repository": "https://github.com/gdesordi/dex-ai",
      "ref": "main",
      "path": "skills",
      "enabled": true
    }
  ]
}

Cada fonte define um identificador único, a URL pública do GitHub, uma branch, tag ou commit, o caminho do catálogo no repositório e se participa das sincronizações. Em workspaces com várias raízes, os comandos globais solicitam qual pasta deve ser usada.

Sincronização

O botão de sincronização no cabeçalho baixa todas as fontes habilitadas, valida seus catálogos, atualiza a cópia local isolada de cada fonte e recompõe o destino do workspace. Skills de mesmo nome em fontes diferentes são rejeitadas.

O botão de sincronização de uma fonte atualiza somente a fonte selecionada. O destino é recomposto com sua nova cópia e com as cópias locais das demais fontes habilitadas.

Durante a composição, a pasta .agents/skills ou .kiro/skills permanece no lugar e somente seu conteúdo é substituído. A extensão mantém uma cópia temporária do conteúdo anterior para restauração em caso de falha. Como o destino inteiro é gerenciado pela Dex, arquivos e skills adicionados manualmente dentro dele são removidos na próxima composição.

Se o download de uma fonte falhar durante a sincronização global, a extensão registra a falha e usa sua última cópia local válida, quando disponível, para compor o destino. Os detalhes ficam no canal de saída Dex.

A verificação de atualizações é manual. Ela compara o commit armazenado de cada fonte habilitada com o commit atual da referência configurada, sem sincronizar o catálogo.

Tree View

A seção Fontes de skills Dex lista as fontes de cada raiz do workspace.

• O botão + abre o cadastro guiado de uma nova fonte.
• O botão de sincronização do cabeçalho atualiza todas as fontes habilitadas.
• Os botões de cada fonte permitem sincronizá-la, abrir seu repositório ou removê-la.
• O menu de três pontos permite adicionar a fonte Dex padrão, abrir .dex/sync.json e verificar atualizações.

Clicar em uma fonte apenas a seleciona; o repositório é aberto pelo botão correspondente. Ao remover uma fonte, é possível preservar ou apagar sua cópia local isolada.

Comandos

• Dex: Sincronizar fontes de skills: sincroniza todas as fontes habilitadas e recompõe o destino.
• Dex: Sincronizar fonte de skills: sincroniza a fonte selecionada e recompõe o destino com todas as fontes habilitadas.
• Dex: Verificar atualizações das fontes: compara os commits locais com as referências remotas configuradas.
• Dex: Adicionar fonte de skills: cadastra uma fonte em .dex/sync.json.
• Dex: Adicionar fonte Dex padrão: inclui o catálogo Dex sem criar duplicatas ou sobrescrever uma fonte conflitante.
• Dex: Abrir configuração de fontes: abre .dex/sync.json para edição.
• Dex: Abrir repositório da fonte: abre no navegador a origem selecionada.
• Dex: Remover fonte de skills: remove a fonte da configuração e oferece a opção de apagar sua cópia local.

Os comandos acompanham o idioma do editor em inglês ou português do Brasil. Nenhuma fonte é consultada ou sincronizada automaticamente durante a ativação.