Pathrule para VS Code

O Pathrule para VS Code é uma interface nativa de editor. Ele traz a árvore de conhecimento do espaço de trabalho, a edição de conteúdo e a configuração de clientes de IA para dentro do editor, de modo que a pasta aberta é o espaço de trabalho e o arquivo que você está editando é o caminho. É a interface certa se você passa o dia no VS Code, no Cursor ou no Windsurf e quer seu conhecimento ao lado do código.

É uma interface de editor focada. O mesmo conteúdo e os mesmos hooks com que o CLI trabalha são controlados pelo editor que você já usa, e a configuração de clientes externos reaproveita o instalador do CLI.

Instalação

Instale pelo Visual Studio Marketplace ou pelo Open VSX, para que Cursor e Windsurf também possam instalá-lo. Pelo terminal:

code --install-extension Pathrule.pathrule-vscode

Ou, no editor, abra o prompt do Quick Open e execute:

ext install Pathrule.pathrule-vscode

Ele é gratuito e de código aberto sob a licença Apache-2.0, e o modo local não exige conta, então você pode começar assim que a instalação terminar.

O que fica a cargo da extensão

• Árvore de conhecimento. Uma barra lateral que mostra apenas os caminhos que têm conhecimento, na mesma estrutura do repositório, com memórias, regras e skills agrupadas em cada caminho. As contagens de conteúdo aparecem como badges nas linhas da árvore e nos arquivos e pastas correspondentes do explorador nativo.
• Sincronização com o arquivo ativo. Conforme você navega entre arquivos, a árvore acompanha o editor até o caminho mais profundo que cobre o arquivo atual, e a barra de status mostra esse caminho com as contagens de conteúdo dele.
• Edição de conteúdo. Memórias, regras e skills abrem como abas comuns de Markdown no editor. Ao salvar, o Pathrule persiste a alteração, e você ganha de graça todas as ferramentas do editor.
• Configuração de agentes. Um único comando conecta seus clientes de IA e instala os hooks vinculados a caminhos, a mesma configuração que o CLI realiza.
• Onboarding. Abra uma pasta que ainda não tem espaço de trabalho e a extensão conduz você da configuração até um espaço de trabalho vinculado, sem sair do editor.
• Doctor. Um único comando que verifica se cada cliente está conectado, se os hooks estão presentes e se o servidor de contexto está acessível.

Modo local e modo Cloud

A extensão funciona em dois modos com uma única interface, a mesma divisão do CLI e do núcleo de código aberto.

• O modo local não exige conta. Inicialize uma pasta localmente e suas memórias, regras e skills ficam na sua máquina. É a forma mais rápida de começar.
• O modo Cloud faz seu login e adiciona a camada de equipe: conhecimento compartilhado, atividade da equipe e o backend gerenciado.

O modo é uma propriedade da pasta aberta, não um palpite. Um usuário com login cuja pasta ainda não é um espaço de trabalho no Cloud recebe as duas opções: criar um na organização atual ou inicializar localmente. Quando uma pasta está em modo local, as ações exclusivas da nuvem ficam ocultas, não quebradas, então a mesma extensão atende aos dois casos.

Edição em abas Markdown

Abra uma memória, regra ou skill pela árvore e ela abre como uma aba Markdown normal. Edite como qualquer arquivo e salve para persistir a alteração. Se alguém da equipe alterou o mesmo item enquanto você estava com ele aberto, salvar não sobrescreve o trabalho dessa pessoa em silêncio: você pode recarregar, guardar uma cópia da sua versão ou sobrescrever com a sua. Conflitos aparecem como uma decisão, nunca como edições perdidas.

No explorador, clique com o botão direito em qualquer arquivo ou pasta para abrir um submenu do Pathrule: navegue pelo conhecimento que se aplica ali ou crie uma nova memória, regra ou skill vinculada àquele caminho. A partir de um item da árvore, você pode copiá-lo como ponteiro de prompt, ver os detalhes, renomeá-lo, movê-lo para outro caminho ou excluí-lo com opção de desfazer. A seleção múltipla permite mover e excluir em lote, e uma busca fuzzy percorre todos os títulos do espaço de trabalho.

Identidade compartilhada com o CLI

Entrar pela extensão usa o mesmo login hospedado do CLI, com a opção de usar GitHub, Google ou e-mail. A sessão é compartilhada: entrar aqui também faz o login no CLI, e trocar de organização em um troca no outro. Uma única identidade na extensão, no CLI e no seu assistente de IA.

Conecte seus clientes de IA

Um único comando, Connect AI clients, conecta seu assistente ao Pathrule sem nenhuma edição de JSON.

• O modo agente do GitHub Copilot recebe o servidor MCP do Pathrule, registrado pela extensão para a pasta vinculada.
• Claude Code, Codex, Cursor e Windsurf recebem entradas MCP gerenciadas, gravadas com o mesmo instalador que o CLI usa.
• Os hooks são instalados pelo mesmo pipeline que o CLI usa, e a notificação de resultado lista exatamente o que foi gravado.

Depois disso, seu assistente recebe o contexto do Pathrule para o caminho atual pelo canal que ele suporta: hooks que incluem um hook de prompt para Claude Code e Codex, hooks de sessão e de ferramenta para Cursor e GitHub Copilot, e um arquivo de regras mais MCP para o Windsurf, que não tem hooks. Execute o comando doctor a qualquer momento para confirmar que cada cliente está conectado e que os hooks estão atualizados.

Trabalho em equipe

As gravações na nuvem são compartilhadas, mas o backend atual do Cloud não oferece assinatura em tempo real. Atualize a visualização de conhecimento ou solicite o contexto novamente para ler o estado mais recente; hooks locais e arquivos de instruções usam o conhecimento preparado até serem atualizados. O trabalho no nível da organização continua no Pathrule Web: gerenciamento de equipe, planos e cobrança, e a visão geral entre espaços de trabalho são acessados por links, em vez de serem reimplementados no editor.

Se você começou no modo local e quer levar uma pasta para a sua equipe, uma única ação faz seu login, escolhe uma organização e copia o espaço de trabalho e o conteúdo dele para a nuvem, mantendo sua cópia local como alternativa.

Quando usar o Pathrule para VS Code

Use a extensão quando você trabalha principalmente no VS Code, no Cursor ou no Windsurf e quer a árvore de conhecimento do espaço de trabalho, a edição de conteúdo e a configuração de agentes no editor que já conhece sua pasta aberta e seu arquivo ativo. Comece no modo local em segundos e entre depois, quando quiser a camada de equipe.

Se você vive no terminal ou automatiza o Pathrule em CI, prefira o Pathrule CLI. Os dois compartilham o mesmo login, então você pode usar ambos.

O que ler em seguida

• Pathrule CLI para o runtime focado no terminal, que compartilha a mesma identidade e os mesmos hooks.
• Núcleo de código aberto para saber o que o modo local executa e o que o Cloud acrescenta.
• Como os hooks funcionam para saber o que a extensão entrega ao seu assistente.