Prepara uma máquina Windows, Linux ou macOS com um comando colado no terminal: instala apps a partir de um catálogo, escolhe versões e roda receitas de várias etapas que continuam depois de um reboot (por exemplo: habilitar o WSL, reiniciar, instalar o Ubuntu e configurar o ambiente de dev dentro dele).
Estado: em desenvolvimento, sem release ainda. Os comandos abaixo mostram como a ferramenta vai funcionar. Nada disso está publicado. "toolkit" é um nome provisório.
toolkit update baixa a última release, confere o SHA-256 pelo checksums.txt e troca o binário (--check só diz se há versão nova, --dry-run mostra o que faria, --version vX.Y.Z escolhe a versão). Nunca usa sudo: se o binário está num diretório do sistema, rode o instalador de novo.
O aviso de versão nova (no fim dos comandos e na TUI, no máximo uma consulta por dia, com cache) roda em segundo plano e nunca atrasa o comando: comandos que terminam em milissegundos raramente chegam a concluí-la, e o resultado fica no cache para a próxima vez. Desligue com --no-update-check ou TOOLKIT_NO_UPDATE_CHECK=1.
O toolkit avisa quando há versão nova: uma linha em stderr no fim do comando e a faixa ↑ v0.2.0 disponível (u) na TUI (a tecla u abre as notas e oferece atualizar). Consulta no máximo uma vez por dia, em segundo plano, sem atrasar o comando, e guarda só a versão, a data e as notas em os.UserCacheDir()/toolkit/update-check.json. Desligue com --no-update-check ou TOOLKIT_NO_UPDATE_CHECK=1; também fica desligado com CI definida, fora de terminal, com --json e em build de desenvolvimento.
Windows (PowerShell 5.1 ou 7, sem administrador):
irm https://github.com/PiluTech/toolkit/releases/latest/download/win.ps1 | iexLinux e macOS:
curl -fsSL https://github.com/PiluTech/toolkit/releases/latest/download/unix.sh | shOs bootstraps são curtos e legíveis (scripts/bootstrap/unix.sh e win.ps1). Eles baixam o binário da
release, conferem o SHA-256 pelo checksums.txt da mesma release e, se divergir, abortam sem instalar.
Instalam no PATH do usuário, sem sudo e sem administrador: ~/.local/bin no Linux e no macOS,
%LOCALAPPDATA%\toolkit\bin no Windows (o script acrescenta essa pasta ao PATH do usuário). Para fixar uma
versão, defina TOOLKIT_VERSION antes de rodar (padrão: a última release). --dry-run só mostra o que
faria: curl -fsSL .../unix.sh | sh -s -- --dry-run ou, no PowerShell,
$env:TOOLKIT_DRYRUN='1'; irm .../win.ps1 | iex. Quem prefere ler antes de rodar baixa o unix.sh,
abre e executa com sh unix.sh.
Abre a TUI ao terminar. Depois de instalar ou atualizar com sucesso, o bootstrap abre toolkit tui na própria
janela (como o winutil). No curl | sh a entrada é o pipe, então o unix.sh liga a TUI ao /dev/tty (só como entrada). Só abre com
terminal de verdade: a saída tem de ser um terminal (com > instalacao.log ou | tee ele só instala e diz como abrir
depois) e a entrada, um terminal ou o pipe do próprio curl | sh (a exceção atendida por /dev/tty); entrada vinda de
arquivo (sh unix.sh < arquivo) não abre. E nunca em CI (CI, GITHUB_ACTIONS, TF_BUILD, GITLAB_CI, BUILDKITE, CIRCLECI,
TRAVIS, APPVEYOR, TEAMCITY_VERSION, JENKINS_URL, CODEBUILD_BUILD_ID; vazio, 0, false, no e off não contam, sem espaços nas pontas nem distinção de maiúsculas, como no envOn do Go),
em sessão remota do PowerShell ou com entrada/saída redirecionada. Para não abrir: TOOLKIT_NO_LAUNCH=1
($env:TOOLKIT_NO_LAUNCH='1'; irm .../win.ps1 | iex no PowerShell), --no-launch (curl ... | sh -s -- --no-launch) ou,
rodando o arquivo salvo, .\win.ps1 -NoLaunch. Se a TUI não abrir ou sair com erro, a instalação continua valendo
(exit 0) e o script diz como abrir depois: toolkit tui.
Depois de instalado:
toolkit # abre a TUI (áreas 0 a 5: Início, Instalar, Máquina, Segurança, Rede, Histórico)
toolkit list # lista o catálogo
toolkit list --installed # e o que já está instalado (inclusive fora do gerenciador)
toolkit install python@3.12 discord git
toolkit install --dry-run vscode # mostra o que faria, sem alterar nada
toolkit recipe list
toolkit recipe run wsl-dev
toolkit recipe status
toolkit diagnostico # saúde da máquina, só leitura: o que está ruim e o que fazer (docs/diagnostico.md)
toolkit usb # modo empresa: USB permitidos (Windows, EXPERIMENTAL; veja docs/usb.md): só lê o estado; aplicar/confirmar/desfazer
toolkit rede # análise da rede, só leitura: IPs, Wi-Fi, DNS, portas em escuta, firewall (docs/rede.md)
toolkit otimizacao # Windows: o que pesa na máquina (CPU, memória, disco, inicialização), só leitura (docs/otimizacao.md)
toolkit rede ip --servico-ip URL # IP público, SÓ sob pedido, com serviço que você informa e confirmação (sem serviço padrão)
toolkit rede portal --servico-portal URL # portal cativo, SÓ sob pedido (mesmas regras)
toolkit resume # chamado sozinho depois do reboot; pode ser rodado à mãoFlags para automação: --no-tui, --yes, --dry-run, --verbose e --catalog <arquivo> (uma URL
só com --catalog-sha256 <hash>, conferido antes de ler o catálogo).
Binários estáticos (sem CGO) para:
| SO | amd64 | arm64 |
|---|---|---|
| Windows 10/11 | sim | sim |
| Linux | sim | sim |
| macOS | sim | sim |
Gerenciadores usados conforme o que existe na máquina: winget (Windows), Homebrew (macOS), apt, dnf, pacman e Flatpak (Linux). Também baixa releases do GitHub e URLs diretas, sempre com hash.
Cada app é declarado uma vez em catalog/catalog.yaml, com uma lista de formas de instalar por SO, em
ordem de preferência. Você escolhe "Discord" e o toolkit usa o primeiro gerenciador que existir na máquina.
apps:
discord:
name: Discord
category: comunicacao
windows: [{ provider: winget, id: Discord.Discord }]
macos: [{ provider: brew, cask: discord }]
linux:
- { provider: flatpak, id: com.discordapp.Discord }
- { provider: apt, package: discord }O catálogo vai embutido no binário e é validado na carga: um erro aponta o arquivo, a linha e a coluna. Rodar a instalação duas vezes não reinstala o que já existe. Formato completo em docs/catalogo.md.
Uma receita é uma sequência de etapas em YAML. Cada etapa pode ter um check: se ele passar, a etapa é
pulada. Quando uma etapa pede reboot, o toolkit salva o estado, registra a retomada (Tarefa Agendada no
Windows, unit systemd no Linux, LaunchAgent no macOS), reinicia e continua de onde parou. Se a mesma
etapa falhar depois da retomada, ele para e reporta, sem entrar em loop de reboot.
Diagnósticos (RAM, disco, sfc, DISM, rede) também são receitas. Formato completo em
docs/receitas.md.
- Não ativa nem contorna licenciamento. Nada de ativadores de Windows ou Office, cracks ou
"keys". O Office entra só pelo Office Deployment Tool oficial, com
config.xmldeclarado. - Não baixa nada sem SHA-256. Uma entrada de URL direta sem
sha256é recusada na validação do catálogo, e uma release do GitHub sem checksum é recusada na instalação. - Não roda
curl | shde terceiros dentro das receitas. Scripts só do próprio repositório, numa versão fixada e com hash conferido. - Não roda a TUI inteira como root. No Linux e no macOS, o
sudovai só nos comandos que precisam. No Windows, o toolkit pede elevação (UAC) só quando algo escolhido exige admin. - Não grava segredos no log. Tokens como o
GITHUB_TOKENsão mascarados.
- docs/arquitetura.md: pastas, interfaces Go e decisões técnicas.
- docs/decisoes.md: as decisões tomadas sobre a proposta, uma por linha.
- docs/catalogo.md: formato do catálogo de apps.
- docs/receitas.md: formato das receitas e ciclo de reboot e retomada.
- CONTRIBUTING.md: como adicionar um app ou uma receita.
- SECURITY.md: como reportar uma vulnerabilidade.
- docs/briefing.md e docs/proposta.md: pedido original e proposta de arquitetura (histórico do projeto).
MIT. Copyright (c) 2026 PiluTech.