Pular para o conteúdo
Pathrule

documentação

O modelo local

O Pathrule pode executar um modelo opcional no seu próprio Mac. Quais Macs são compatíveis, como instalar, atualizar e remover o modelo com o CLI, para que ele serve, como funciona o uso offline e o que acontece quando ele não está presente.

Nesta página

Certos tipos de compreensão funcionam melhor onde o seu trabalho está.

O Pathrule Intelligence pode executar um modelo na sua própria máquina. Ele é opcional e existe para entender conhecimento, não para escrever código. Ele consegue transformar uma preferência que você ensina em User Intelligence estruturada e compilar o conhecimento do espaço de trabalho em orientações fundamentadas na fonte que a sua equipe escreveu. O runtime valida essas orientações compiladas antes de usá-las e recorre ao texto de origem quando não é possível confirmar a cobertura. A inferência local não envia a entrada para um provedor de modelos externo.

O que é instalado

Duas partes: um runtime dedicado para o modelo e o próprio modelo. Ambos ficam no seu diretório home do Pathrule, ~/.pathrule por padrão, ou onde quer que PATHRULE_HOME aponte. O Pathrule traz e verifica tudo de que o runtime precisa, então a instalação não depende das ferramentas que o seu Mac já tem.

pathrule intelligence install   # download, verify and activate
pathrule intelligence status    # installed version, and whether an update is available
pathrule intelligence update    # move to the latest version
pathrule intelligence remove    # remove it

Em um Mac compatível, o pathrule setup oferece o download uma única vez. Se você recusar, ele não pergunta de novo, e você pode rodar pathrule intelligence install quando quiser.

Tamanho e plataforma

FinalidadeEntender conhecimento, não escrever código
DownloadVários gigabytes; o pathrule setup mostra o tamanho antes de você concordar
PlataformaMac com Apple Silicon, macOS 14 (Sonoma) ou posterior

Os requisitos são verificados logo de início. Em um Mac sem Apple Silicon, ou com macOS anterior ao 14, o setup não oferece o modelo, e uma tentativa de instalação é interrompida informando esse motivo, em vez de baixar gigabytes e falhar no final. No Linux e no Windows, o CLI funciona plenamente sem ele.

Quando algo dá errado durante o setup, a mensagem indica a etapa e a causa, como falta de conexão, um proxy, disco cheio ou um macOS mais antigo.

Ciclo de vida e atualizações

O pathrule intelligence status informa a situação da instalação: não instalado, pronto, atualização disponível ou um erro com o respectivo motivo.

Três garantias valem o tempo todo:

  • Uma versão só é ativada depois de verificada. Um download que não corresponde ao que o Pathrule publicou nunca é usado.
  • Um download com falha ou corrompido nunca afeta a versão ativa. O modelo instalado anteriormente, se houver, continua exatamente como estava.
  • Atualizações não exigem uma nova versão do CLI. O pathrule intelligence update busca a versão publicada mais recente, seja ela qual for.

Carregamento e descarregamento

O modelo não fica residente o tempo todo. Ele é iniciado sob demanda, somente na sua máquina, passa por uma verificação de que está realmente respondendo antes que qualquer coisa o use e é descarregado de novo após um período de inatividade. A primeira solicitação depois de um período ocioso demora visivelmente mais do que as seguintes.

Offline

Depois de instalado, o modelo não precisa de rede para entender o que você ensina a ele. Já a instalação e a atualização precisam. O Pathrule Cloud, se você o usa, é outra coisa (veja abaixo).

Quando o modelo não está presente

Nada do que entrega conhecimento depende dele. Memórias, regras, skills, descobertas e as preferências que você já ensinou continuam chegando aos seus agentes exatamente como antes, com ou sem o modelo instalado.

Ensinar uma nova preferência e a compreensão local assistida pelo modelo dependem dele. Sem o modelo, o pathrule me teach avisa que o modelo no dispositivo não está disponível e explica como instalá-lo, em vez de armazenar algo que não conseguiu verificar. Todos os outros comandos pathrule me funcionam sem ele.

O que "local" significa e o que não significa

Esta é a frase que precisa continuar precisa.

Verdade: quando você ensina uma preferência ao Pathrule, a inferência roda no seu dispositivo, e o resultado fica armazenado na sua máquina. O modelo recebe o conhecimento ou a entrada de ensino necessária para a operação, não um upload automático do seu repositório.

Também verdade, e separado: o Pathrule tem serviços em nuvem para contas, equipes, cobrança, sincronização de espaços de trabalho e distribuição do próprio modelo. No modo Cloud, o início de cada prompt é enviado ao Pathrule Cloud para priorizar o conhecimento do espaço de trabalho, e o pathrule snapshot, quando você ou o seu agente o executam, envia uma descrição do projeto. E quando você usa o Claude Code, o Codex ou qualquer outro agente de programação, as fronteiras do provedor desse agente se aplicam a tudo o que você envia a ele.

São três fronteiras, não uma. Segurança e privacidade descreve cada uma delas.