Instalação do plugin /dr

Compatível com dr3.4.25

O plugin /dr é instalado pelo wisework, o instalador de linha de comando da plataforma WiseWork. Um único comando conecta a máquina à sua conta, instala os plugins da sua instância, registra a conexão com a plataforma e ajusta as preferências do Claude Code. Quem decide qual plugin a sua instância recebe é a plataforma; nas instâncias que usam o /dr, é ele que o instalador traz.

Pré-requisitos

Node.js 18 ou mais recente (o instalador roda com npx).
Claude Code 2.1.238 ou mais recente, instalado e no PATH.
Acesso à sua conta na plataforma WiseWork pelo navegador, para gerar o código de pareamento.
python3 3.7 ou mais recente e git. Todos os hooks do plugin são scripts Python: sem python3, nenhum deles roda. O instalador confere python3, git e Node, mas não os instala.

Instalar

npx -y wisework@latest install --slug=<slug>

O <slug> é o identificador da sua instância WiseWork: acme para acme.wisework.ia.br. O -y é do próprio npx e só dispensa a confirmação de download do pacote; o @latest garante que o npx use a versão mais recente do instalador, e não uma cópia antiga guardada no cache.

Na primeira vez, o instalador conecta a máquina à sua conta:

Pressione Enter: o navegador abre a página de pareamento da sua instância (faça login se for pedido).
Copie o código exibido na página e digite-o no terminal.

A conexão fica salva na máquina, e as próximas execuções não pedem o código de novo. Nenhum token precisa ser copiado ou colado.

O que o instalador faz

Depois do pareamento, o instalador:

Registra os plugins da instância. Adiciona ao Claude Code o marketplace servido pela plataforma (wisework no canal estável, wisework-beta com --channel=beta), com a atualização automática ligada, e instala por ele os plugins da sua instância.
Configura a conexão com a plataforma. Registra o servidor MCP workforce no escopo de usuário e ajusta no ~/.npmrc a credencial que ele usa para baixar o pacote. Se o MCP workforce já foi registrado pelo instalador, ele é mantido quando o token é o mesmo e trocado quando muda; um registro feito por fora só é substituído depois de perguntar. --skip-mcp pula esta etapa.
Copia os arquivos de configuração que o plugin declara para ~/.claude/: os arquivos de framework (CLAUDE.md, RULES.md e os demais), os scripts da statusline e o catálogo de ferramentas. Se você editou um desses arquivos, o instalador pergunta se sobrescreve (com backup em ~/.claude/backups/<data>/) ou mantém o seu.
Faz perguntas de preferência, todas com um valor sugerido que o Enter aceita:
- Aparência: statusline (compact, standard, full ou nenhuma) e estilo de resposta padrão (dr:Minimal, dr:Direct and Objective ou o padrão do Claude Code), gravados em ~/.claude/settings.json.
- Ferramentas: instalação do RTK, dos servidores LSP de TypeScript e Python e de ferramentas de apoio, como jq, gh, uv e playwright.
- Preferências: nome, idioma, fuso horário, idioma e verbosidade de commits, PRs e reviews, e backup da transcrição antes de cada compactação.

No fim, aparece um resumo com o que foi feito e o comando sugerido para começar. Rodar o instalador de novo completa o que faltou: plugins e conexão já configurados são mantidos, e as perguntas são refeitas. Para automação, --yes aceita os valores sugeridos sem perguntar; as flags de cada pergunta estão em npx -y wisework@latest --help.

Verificar

Abra ou reinicie o Claude Code: plugins, hooks e o MCP só carregam no início da sessão. Na primeira sessão num projeto, o hook de início cria a estrutura .dr_ai/, adiciona .dr_ai/ ao .gitignore e grava as regras do plugin em .claude/rules/ (um arquivo por tema, feitos para entrar no commit do projeto). Para confirmar que os comandos estão disponíveis:

/dr:talk:help

Você deve ver o guia de comandos do DR_AI, e digitar /dr: deve listar os comandos do plugin no autocomplete. No terminal, npx -y wisework@latest status mostra o que está instalado, divergente ou pendente.

Atualizar

Versões novas do plugin chegam sozinhas, pela atualização automática em segundo plano do Claude Code. Essa atualização não toca nos arquivos que o instalador copiou para ~/.claude/. Para atualizar na hora, incluindo esses arquivos:

npx -y wisework@latest update

O update usa a conexão salva, atualiza o marketplace e os plugins pelo Claude Code e copia de novo os arquivos de configuração quando a versão do plugin muda. Reinicie as sessões do Claude Code depois para carregar a nova versão.

Para refazer só as perguntas de preferência, sem tocar nos plugins, use npx -y wisework@latest setup.

Migrar de uma instalação antiga pelo marketplace

Se o /dr foi instalado antes pelo marketplace da Digital Republic (dr@dr-marketplace), essa cópia não recebe mais atualizações: o /dr saiu desse marketplace e hoje é distribuído só pelo instalador wisework. O instalador se recusa a continuar enquanto essa cópia estiver ativa: dois /dr ativos colidem nos mesmos comandos dr:. Desinstale a cópia antiga antes e rode o install:

claude plugin uninstall dr@dr-marketplace
npx -y wisework@latest install --slug=<slug>

Os arquivos de framework que a instalação antiga deixou em ~/.claude/ são reconhecidos pelo cabeçalho de versão e atualizados, com backup.

Desinstalar

npx -y wisework@latest uninstall --all

Remove os plugins, o marketplace, o MCP que o instalador registrou e os arquivos de configuração que você não editou, além de desconectar a máquina da conta (os tokens do pareamento são revogados na plataforma). Arquivos editados por você, os backups em ~/.claude/backups/ e as ferramentas de apoio instaladas ficam.

Ver também

O diretório .dr_ai — o que o plugin grava no seu projeto
Hooks — o que roda automaticamente em cada sessão
O MCP do WiseWork — o que a conexão com a plataforma permite e como ela é registrada
Comandos do /dr — o catálogo completo