COMECE AQUI / 02

Instalar e atualizar

Requisitos, instalação passo a passo, o que conferir na primeira abertura, como atualizar sem perder sessões e como desinstalar.

Atualizado para o PrumoGrid 0.5.11

Antes de instalar

Item	Precisa?	Para quê
Windows 10 1809 ou mais novo, ou Windows 11, 64 bits	Sim	Os terminais rodam no ConPTY do Windows.
Node.js	Não	O instalador traz o que o aplicativo precisa.
Claude Code, Codex ou outra CLI de agente	Só para usar agentes	O PrumoGrid chama a CLI que já está instalada e autenticada no seu computador. Ele não instala nem faz login por você.
Git 2.17 ou mais novo	Para worktrees e revisão de alterações	Sem Git, os terminais, as etapas e as regras funcionam; só essas telas ficam de fora.
WSL e Git Bash	Opcionais	Aparecem como opção de terminal quando estão instalados. No WSL, a CLI do agente precisa estar instalada e autenticada do lado Linux.

Para conferir o que já existe, abra um PowerShell e rode estas consultas. Nenhuma delas altera nada:

powershell

Get-Command claude, codex -ErrorAction SilentlyContinue
git --version
wsl.exe --list --verbose

Instalar

Baixe PrumoGrid-Setup-0.5.11.exe na página de download do site (cerca de 90 MiB).
Se quiser conferir o arquivo, rode Get-FileHash .\PrumoGrid-Setup-0.5.11.exe -Algorithm SHA256 na pasta do download e compare com o SHA-256 publicado na página.
Execute o instalador. Ele ainda não é assinado digitalmente, então o Windows pode avisar que o editor é desconhecido.
Leia o Acordo de Licença (Licença de Uso Gratuito do PrumoGrid 1.0) e aceite em Eu Concordo.
Escolha Apenas para mim (o padrão, sem pedir administrador) ou Para todos que usam esta máquina.
Confira a pasta. O padrão é %LOCALAPPDATA%\Programs\PrumoGrid, com cerca de 313 MB.
Termine com Executar o PrumoGrid marcado.

O instalador cria o atalho PrumoGrid no Menu Iniciar. Seus dados (projetos, layout, rotinas, regras gerais) ficam em %APPDATA%\TerminalGrid, separados da pasta do programa.

Primeira abertura

Abra o PrumoGrid pelo Menu Iniciar.
Olhe o rodapé, à esquerda: daemon conectado quer dizer que o serviço de terminais está rodando. É ele que mantém as sessões vivas quando a janela fecha.
A coluna da esquerda diz Adicione uma pasta para começar. e oferece + adicionar projetos….
Siga para o primeiro projeto em 10 minutos.

Num terminal aberto pelo PrumoGrid, tg --help mostra a ajuda da integração local. Esse comando só existe nos terminais do PrumoGrid.

Atualizar

O PrumoGrid avisa quando há versão nova. A atualização é assinada: o aplicativo confere a assinatura do manifesto e a integridade do instalador antes de instalar.

Abra Ferramentas → Opções avançadas…, seção Atualizações. Verificar agora consulta na hora; com Verificar ao abrir e a cada 6 horas ligado, o aplicativo consulta sozinho. Quando há versão nova, a tela mostra as notas em O que mudou.
Escolha Baixar atualização. Se a licença mudou, o texto aparece para você ler e aceitar antes do download.
Depois da conferência do arquivo, escolha Instalar atualização.
Escolha Reabrir agora ou Ao fechar. Com Ao fechar, a instalação acontece quando você fechar a janela.

O diálogo diz se a versão nova troca o serviço de terminais:

Esta atualização não troca o serviço: os terminais e as sessões continuam depois de reabrir.
Esta atualização troca o serviço: ao reiniciar o serviço, as sessões abertas serão encerradas. Escolha o momento conforme o trabalho em andamento.

Você também pode rodar o instalador novo por cima da instalação atual, sem desinstalar. Feche a janela do PrumoGrid antes; os terminais continuam no serviço e voltam quando o aplicativo reabrir. Quem vem da 0.5.4 instala a 0.5.11 pelo site e aceita a Licença de Uso Gratuito na tela do instalador.

A linha "O serviço em execução é de outra versão."

Instalar uma versão nova não derruba o serviço que está guardando suas sessões. Quando o código do serviço em execução é diferente do instalado, aparece uma linha discreta no topo da janela: O serviço em execução é de outra versão.

Linha do serviço de outra versão no topo da janela, com Reiniciar agora e Depois. — A linha aparece só quando o código do serviço mudou. Nada obriga a reiniciar na hora.

Reiniciar agora pede confirmação, diz quantas sessões serão encerradas, reinicia o serviço e reabre o aplicativo.
Depois esconde a linha até a próxima abertura.

Na passagem da 0.5.10 para a 0.5.11 a linha aparece uma vez, porque o serviço da 0.5.10 não informa qual código executa. Daí em diante, só quando o serviço mudar de fato. Reabrir só a janela não atualiza o serviço.

Desinstalar

Em Configurações → Aplicativos instalados, escolha PrumoGrid 0.5.11 → Desinstalar (ou rode Uninstall PrumoGrid.exe na pasta do programa). O desinstalador encerra o aplicativo e o serviço e remove a pasta do programa e o atalho.

A pasta %APPDATA%\TerminalGrid fica, com seus projetos, layout e rotinas, e reinstalar recupera tudo. Para apagar também os dados, remova essa pasta à mão. Arquivos gravados nos seus repositórios, como o bloco do PrumoGrid no CLAUDE.md ou .terminal-grid\regras.json, também ficam: são arquivos do seu projeto.

Dicas

O registro do serviço, terminal-grid-daemon.log, fica na pasta temporária do Windows (%TEMP%). Cada arquivo vai até 50 MB e o PrumoGrid guarda no máximo três (.log, .log.1 e .log.2); o mais antigo é descartado.
Quem precisa de um ambiente separado (para ensaiar sem misturar com o trabalho do dia a dia) pode definir a variável TG_PROFILE antes de abrir o aplicativo: com TG_PROFILE=ensaio, os dados vão para %APPDATA%\TerminalGrid-ensaio, com projetos e serviço próprios.
O nome anterior do produto era Terminal Grid. Por isso a pasta de dados, o comando tg, as variáveis TG_* e a pasta .terminal-grid mantêm esse nome.

Limites conhecidos

O instalador não tem assinatura Authenticode. A conferência da atualização usa a assinatura do manifesto do PrumoGrid, que é outra coisa.
O PrumoGrid é só para Windows nesta versão.
O sandbox do Chromium vem desligado. Veja Idioma e sandbox.
O código-fonte não é distribuído com esta versão.