d3k: deixe um assistente assumir a linha do tempo de depuração Web local

Para quem

d3k é para quem depura um app Web localmente e quer que um assistente de código veja a linha do tempo completa. Ele inicia seu servidor de desenvolvimento, abre um navegador monitorado com configuração Chrome estável do projeto, e junta logs do servidor, erros do navegador, atividade de rede, interações e capturas numa só linha do tempo.

A interface principal é a skill d3k: diga ao assistente o que quer testar ou inspecionar e deixe-o assumir o runtime. Não é um script genérico de «abrir outro navegador», nem o caso de você levantar outro servidor de desenvolvimento e pedir ao assistente que adivinhe os logs.

Antes de usar é preciso Node.js 24 ou mais novo. A instalação da skill e a do runtime são dois comandos; não os misture numa linha. Num ambiente sem suporte a skill, não aplique o comando de instalação da skill.

Primeira tentativa em 3 minutos

O comando oficial da skill é bunx skills add vercel-labs/dev3000 --skill d3k --agent '*' -g -y. O repositório é https://github.com/vercel-labs/dev3000 Siga só essa página. O comando oficial do runtime é bun install -g dev3000. A documentação também diz que npm install -g dev3000 funciona, mas o caminho principal segue bun; não invente um terceiro instalador.

Pré-requisitos: esta máquina tem Node.js ≥ 24, um projeto Web que pode iniciar localmente, e você aceita o assistente levantar um navegador monitorado. A skill instala no lado do assistente (o comando traz -g); o runtime instala como pacote global dev3000. Depois de instalar, confirme primeiro que o assistente consegue falar de d3k e só então decida iniciar.

Primeira tarefa de baixo risco: use um app local descartável. Diga com clareza ao assistente: iniciar d3k de forma não interativa, manter o processo em segundo plano, reutilizar o navegador que ele gerencia e olhar só a evidência unificada. Antes de iniciar, confirme a porta e o diretório do projeto; não aponte para produção. Sinal de sucesso: aparece uma linha do tempo com carimbo de tempo (logs, erros, rede ou capturas) e o assistente não abriu à parte outro servidor de desenvolvimento nem outro navegador.

Se quiser só confirmar a instalação, pergunte primeiro «como iniciar d3k de forma não interativa» e aprove só depois de ver o comando que ele vai executar. A documentação não escreve número de porta padrão nem como parar o processo; na primeira vez pergunte como parar antes de iniciar.

Casos de uso

Caso 1: entregar a depuração à skill d3k. Depois de instalar a skill, descreva o problema da página a reproduzir e deixe o assistente ter o runtime. Serve quando você já consegue dizer numa frase qual página, qual ação e qual erro viu. Não há comando com barra fixo; linguagem natural basta. Se o assistente começar sozinho npm run dev e abrir o navegador do sistema, peça para passar ao d3k. A página de confronto é https://github.com/vercel-labs/dev3000

Caso 2: com o runtime global instalado, deixar o assistente iniciar de forma não interativa e só ler a linha do tempo. A skill ensina: início não interativo, manter o processo em segundo plano, reutilizar o navegador hospedado, inspecionar evidência unificada — não abrir outro servidor ou navegador. Serve para regressar uma interação conhecida quando rede e capturas precisam ser vistas juntas. A documentação não lista caminho de arquivo da linha do tempo nem endereço de UI; você só chega até «depois de iniciar, ver evidência na entrada que o assistente der». Até ver a linha do tempo unificada, não abra um segundo monitor ao mesmo tempo.

Limites de uso

Limite de versão: Node.js 24 ou mais novo. Limite de instalação: a skill usa bunx skills add vercel-labs/dev3000 --skill d3k --agent '*' -g -y; o runtime usa bun install -g dev3000 (npm também). Sem skill, não aplique o primeiro. Limite de uso: a interface principal é dizer o objetivo ao assistente e deixar o runtime com ele; reutilize o navegador hospedado e a linha do tempo unificada, não abra outro servidor ou navegador. Limite de alcance: servidor de desenvolvimento local, navegador monitorado, logs, erros, rede, interações e capturas; não escreve ambiente remoto nem sondagem de produção. Parada e porta não estão detalhadas; pergunte com clareza na primeira vez antes de iniciar.