Um assistente parecido com o Claude Code, rodando no seu computador

01Pra que serve

Entender uma pasta de projeto que você não conhece: o que tem nela, como está organizada e quais são as partes principais.
Pedir em português pra ele ler, criar ou alterar arquivos, e rodar comandos por você.
Dividir uma tarefa grande em etapas e ir cumprindo uma por uma, com um plano que você acompanha.
Funciona com a sua chave da DeepSeek, ou pelo Ollama com um modelo como o Qwen, sem precisar de plano da Anthropic.

02O que você precisa

Node.js instalado (programa gratuito que roda ferramentas como essa)
Uma chave da DeepSeek, criada em platform.deepseek.com
Ou, no lugar da chave: o Ollama instalado (programa que roda modelos de IA no seu computador)
Uma pasta de projeto pra ele trabalhar

03Passo a passo

Instale o Node.js. No Windows, baixe o instalador do site e clique em Avançar até o fim.
```
https://nodejs.org
```
Abra o terminal dentro da pasta do projeto (no Windows, o PowerShell) e rode o comando abaixo. Ele abre sozinho no navegador, no endereço http://127.0.0.1:3080. O programa já começa na pasta onde você rodou o comando.
```
npx @deepseek-ai/dsh web
```
No navegador, vá em Settings → Models (Configurações, Modelos), cole a sua chave da DeepSeek e salve. Já funciona na hora, não precisa reiniciar. A chave você cria aqui:
```
https://platform.deepseek.com/
```
Clique em Choose workspace (escolher pasta), adicione a pasta do projeto onde você rodou o comando e selecione. Enquanto nenhuma pasta estiver escolhida, a caixa de pedido fica travada.
Abra uma sessão e escreva o seu pedido, como nos prompts abaixo. Quando ele pedir autorização, leia o que vai fazer antes de aprovar.
Sem chave da DeepSeek: com o Ollama instalado, esta linha instala e abre o programa já com o modelo Qwen.
```
ollama launch dsh --model qwen3.8
```

04Pedidos prontos pra colar na sessão

Entender um projetoO primeiro pedido, assim que escolher a pasta

Resuma esta pasta em português, como se eu nunca tivesse programado.
Me diga: pra que serve esse projeto, quais são as partes principais, onde fica cada uma e por qual arquivo eu começo a ler.
Não altere nenhum arquivo, só leia.

Resolver um erroQuando um comando dá erro e você não entende a mensagem

Quando eu rodo [COMANDO QUE VOCÊ RODOU], aparece este erro:
[COLE A MENSAGEM DE ERRO]
Explique em português simples o que ele quer dizer e qual a causa provável nesta pasta.
Antes de mudar qualquer arquivo, me mostre o que pretende alterar e espere eu aprovar.

Arrumar uma pasta bagunçadaPra organizar arquivos sem perder nada

Olhe a pasta [NOME DA PASTA] e me proponha uma organização em subpastas, com nomes claros em português.
Mostre primeiro a lista: arquivo atual -> onde ele vai ficar.
Não apague nada. Só mova os arquivos depois que eu disser ok.

Criar algo do zeroPra fazer uma página ou ferramenta simples

Crie nesta pasta uma página simples de [ASSUNTO, ex.: lista de tarefas da semana] que abra direto no navegador, sem instalar nada.
Antes, me mostre um plano curto com os arquivos que vai criar.
No fim, me diga em qual arquivo eu clico pra abrir.

05Antes de usar

É uma versão de teste: pode mudar e quebrar de uma atualização pra outra.
Ele mexe de verdade nos arquivos e roda comandos no seu computador, e ainda não passou por auditoria de segurança. Use numa pasta de teste ou com cópia de segurança, e só aprove o que você entendeu.
Usar a chave da DeepSeek é cobrado na sua conta da DeepSeek. Confira os valores em platform.deepseek.com antes de pedir tarefas longas.
Pelo Ollama, a busca na internet só funciona se você entrar na sua conta do Ollama (comando ollama signin) e usar um modelo que aceite ferramentas.
Licença MIT: pode usar à vontade, mas por sua conta e risco.

Resumindo: um comando abre o programa no navegador, você cola a chave (ou usa o Ollama), escolhe a pasta e pede em português. Ele pergunta antes de fazer o que precisa de permissão.

Seguir @alvim_ai Repositório oficial no GitHub

Todos os guias e prompts do Alvim