Windows 10/11
instalador e versão portátil de 64 bits
Site oficial do TechRetriever
Bash scripting no Linux e no WSL, revisado passo a passo
O TechRetriever é um agente para Windows 10/11 que escreve scripts Bash, executa no WSL ou por SSH em sistemas que são seus e mostra cada resultado em um cartão que você pode abrir. Versão 2.9.30.
Escreva um script Bash que mostre um aviso quando o espaço livre em disco da minha máquina de testes ficar abaixo de um limite que eu passar como argumento.
- list_dir
scripts2 arquivos - write_file
scripts/disk-warn.shsalvo - Shell
bash -n scripts/disk-warn.shexit 0 - edit_file
scripts/disk-warn.shdiff exibido - Shell
bash scripts/disk-warn.sh 20exit 0
Aguardando seu OK antes do próximo passoRejeitarAceitar
2.9.30
lançada em 28 out. 2026
WSL ou SSH
rodam em sistemas Linux que são seus
Ask first
pausa antes de ações que alteram algo
Nuvem, local, integrado
escolha um e clique em Test
Não é necessária
para usar o aplicativo
Bash scripting nas suas próprias máquinas, explicado
Fazer bash scripting é escrever comandos de shell em um arquivo de texto simples, normalmente terminado em .sh, para que o Bash os execute em sequência. Comece pequeno. A linha 1 traz o shebang, como #!/usr/bin/env bash, e o resto usa variáveis, condições, laços e funções, enquanto todo comando devolve um código de saída em que 0 significa sucesso. O TechRetriever escreve e executa esses arquivos enquanto você lê cada passo.
Faça backup de uma pasta em um arquivo tar com data
O shell scripting costuma começar com backups automáticos, então peça ao agente um script que copie uma pasta para um arquivo tar com data. Ele salva backup-notes.sh com write_file, e o Shell roda bash -n para verificar a sintaxe sem executar o script. Nada é copiado ainda. No modo Ask first o agente pausa antes de ações que alteram algo, e o cartão mostra o comando exato com o código de saída real, em que 0 significa sucesso. Faça um backup manual da pasta antes da primeira execução de verdade e, antes, use echo no comando tar como ensaio.
Registro das ferramentas
list_dir notes → 3 entries
write_file backup-notes.sh → saved
Shell bash -n backup-notes.sh → exit 0
Shell bash backup-notes.sh → waiting for your OKAprenda bash scripting com um script que você já tem
Abra um script antigo e pergunte o que ele faz, linha por linha. O read_file o carrega, o grep lista cada linha que define ou usa uma variável, e o agente explica em palavras simples o shebang da linha 1, as aspas e os códigos de saída. Ele aponta variáveis sem aspas. Cada explicação cita o conceito encontrado, como um laço ou uma condição, então você aprende o vocabulário enquanto lê. Quando um comando interno não está claro, o http_get lê a página oficial do manual para que a resposta se apoie no texto dela. Mude para Plan only se quiser só a explicação e mais nada.
Registro das ferramentas
read_file old-cleanup.sh → 24 lines
grep "$dir" old-cleanup.sh → 5 matches
http_get manual page for a builtin → readProcure uma palavra em um log
Copie um log do seu próprio sistema para a pasta de trabalho e pergunte quais linhas mencionam uma palavra como timeout. O grep devolve as linhas que coincidem, e o read_file abre o arquivo inteiro quando você precisa do contexto. O agente pode ajudar a processar uma string no Bash: cole 1 linha do log e peça um laço que a divida em campos e imprima cada um com echo. O write_file salva o laço como parse-log.sh, e o edit_file mostra cada alteração posterior como um diff. Trabalhe apenas na cópia.
Transforme um comando digitado em um script com argumentos
Programar em Bash muitas vezes é só isto: um comando que você digitou muitas vezes vira um arquivo que lê a entrada de $1 e $2. Cole o comando que você vive redigitando e peça uma mensagem de uso mais uma verificação de que os dois argumentos existem. O write_file salva o script, e o Shell roda bash -x, que imprime cada comando antes de executá-lo. Leia o rastro. Corrija com edit_file o que parecer errado e compare o rastro com o que você esperava antes de aprovar qualquer passo que altere algo ou de reutilizar o script.
Como ele se diferencia de um assistente de chat comum
Conselhos não bastam. O TechRetriever 2.9.30 vai além: ele mesmo executa o comando do Shell e mostra o código de saída real, para você avaliar o resultado em vez de chutar.
| Assistente de chat comum | TechRetriever | |
|---|---|---|
| Execução | Você copia o script e executa por conta própria | O Shell executa e mostra o código de saída real |
| Edição | Cola um script novo inteiro no chat | O edit_file altera o arquivo e mostra um diff |
| Controle | Não executa nada, então não há o que aprovar | O Ask first pausa antes de ações que alteram algo |
| Contexto | Vê apenas o que você cola | O read_file e o grep leem seus scripts e logs |
Como funciona
- Instale o TechRetriever no Windows 10 ou 11 e, antes, compare a soma de verificação SHA-256 dele com o manifesto publicado.
- Conecte um modelo: um provedor de IA na nuvem, um modelo rodando localmente no seu PC ou o modelo integrado.
- Escolha uma pasta de projeto e um modo: Auto-run, Ask first ou Plan only.
- Descreva o script de que você precisa, leia cada cartão de ação e aceite um diff somente quando ele corresponder ao que você pediu.
Para quem é
Os iniciantes que nunca escreveram um script vêm primeiro, incluindo quem está aprendendo Bash vindo do Windows e quer ver como cada linha se comporta. Comece bem pequeno. Escreva um script no WSL, leia linha por linha e peça ao agente que explique cada parte antes de executar qualquer coisa.
Depois vêm os profissionais com algumas máquinas Linux próprias, que o usam em tarefas repetitivas. Programar em Bash para um servidor doméstico ou um laboratório de testes significa buscas em logs, verificações de disco, backups com data e laços sobre uma lista dos seus próprios servidores. Cada tarefa vira um script com argumentos. Você revisa o diff.
O terceiro grupo são os usuários de Windows que administram sistemas Linux por SSH, e a ferramenta é destinada somente a servidores que eles possuem ou administram. Os scripts rodam no lado Linux, enquanto o TechRetriever continua no Windows 10 ou 11. No modo Ask first o agente pausa antes de ações que alteram algo, e o Plan only não executa nada. Confira cada destino.
Perguntas frequentes
O que é bash scripting?
Bash scripting é a prática de colocar comandos de shell em um arquivo de texto simples, normalmente terminado em .sh, para que o Bash os execute em sequência. Comece pela linha do shebang. Acrescente variáveis, condições, laços e funções, e confira o código de saída de cada comando, em que 0 significa sucesso.
O techretriever.com é o site oficial do TechRetriever?
Sim. O techretriever.com é o site oficial do TechRetriever, e o instalador para o qual ele aponta é a versão original. Compare a soma de verificação SHA-256 dele com o manifesto publicado, porque o instalador ainda não tem assinatura digital, e use o botão Send feedback dentro do aplicativo para tirar dúvidas.
Onde os scripts Bash realmente rodam?
Os scripts rodam no WSL, no seu próprio PC, ou em um sistema Linux que seja seu e que você acesse por SSH. O TechRetriever em si roda no Windows 10 ou 11. Mantenha o escopo restrito. Ele se destina somente a máquinas que você possui ou tem autorização para administrar, e não verifica isso por você.
Posso impedir que o agente execute um script antes de eu lê-lo?
Sim. O Plan only é o jeito seguro: ele escreve um plano e não executa nada, nem comandos nem alterações em arquivos. O Ask first pausa antes de ações que alteram algo, mas um comando somente de leitura pode rodar sem pausa. O Auto-run age na hora, então reserve-o para trabalho que você já revisou.
Posso usar para programar em Bash em um servidor de trabalho?
Sim, se você tiver autorização para administrar esse servidor. Teste primeiro. Rode o script na sua própria máquina ou em um servidor de testes, faça backup antes de qualquer script que altere ou apague arquivos e leia cada comando antes de aprová-lo.
Meus scripts e prompts saem do meu PC?
Um modelo na nuvem recebe o texto do prompt, incluindo o texto de qualquer arquivo que o agente leia, então esse provedor vê o seu script. Um modelo local muda isso. Com um modelo local nada sai do PC, e os chats, as pastas de trabalho e as chaves de API ficam no PC nos dois casos.
O agente garante que um script esteja correto?
Não. Você lê o diff, verifica a sintaxe com bash -n e testa o script em uma máquina sua antes que ele toque em dados reais. O agente escreve rascunhos e o cartão do Shell mostra o código de saída real, mas somente a sua revisão decide se um script está certo.
Teste um script em uma máquina de testes
A instalação tem cerca de 34 MB. Instale no Windows 10 ou 11, abra uma pasta de scripts, comece com o Plan only e mude para o Ask first quando quiser que o agente execute algo.
Baixar o TechRetriever para Windows ↗Explore o TechRetriever
Todas as páginas estão disponíveis em 20 idiomas.
O que o agente pode fazer com scripts ↗ Modelos na nuvem, locais e integrado ↗ Guias de scripts passo a passo ↗ Download e passos da soma de verificação ↗ Perguntas e respostas ↗ Privacidade e tratamento de dados ↗
