App desktop
O app desktop oferece uma superfície dedicada para sessões de Code e pode trabalhar mais perto do ambiente local.
Quando preferir
- Sessões longas de desenvolvimento.
- Tarefas que precisam de mais acesso local.
- Uso frequente de editor e terminal.
Mesmo modelo mental
Sessões, arquivos, editor, terminal, preview e revisão continuam sendo as peças principais; a diferença é a superfície de execução.
Quando o app instalado faz diferença
A experiência desktop existe para tarefas que precisam de filesystem, processos locais e integração mais próxima do ambiente de desenvolvimento.
- Use o desktop quando o navegador virar o limitador do trabalho, não apenas porque a tarefa é “de código”.
Visão prática
Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em App desktop, onde o contexto pode atravessar mais de uma etapa.
Comece por “Quando preferir”, confirme o estado visível e avance para “Mesmo modelo mental” apenas quando a etapa anterior estiver estável. Em App desktop, pular contexto costuma gerar mais retrabalho do que velocidade.
No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.
- confirme o estado antes de iniciar a próxima ação
- mantenha arquivos, sessão e contexto ligados ao mesmo objetivo
- trate mensagens de erro como dados de diagnóstico, não como detalhe visual
Fluxo mínimo
Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando App desktop realmente exigir mais contexto, controle ou verificação.
Imagine uma tarefa real em que App desktop deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.
Escalando com segurança
Use App desktop como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O app desktop oferece uma superfície dedicada para sessões de Code e pode trabalhar mais perto do ambiente local. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.
- trate mensagens de erro como dados de diagnóstico, não como detalhe visual
- revise a saída no mesmo ambiente em que ela será usada
- confirme o estado antes de iniciar a próxima ação
Como saber que funcionou
Comece por “Quando preferir”, confirme o estado visível e avance para “Mesmo modelo mental” apenas quando a etapa anterior estiver estável. Em App desktop, pular contexto costuma gerar mais retrabalho do que velocidade.
Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em App desktop, onde o contexto pode atravessar mais de uma etapa.
Checklist de integração: App desktop
Nesta página, a referência completa cobre filesystem real, terminal, Computer Use, setup, atualização e segurança. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.
- confirme o estado inicial antes de executar a ação
- identifique quais dados ou arquivos a superfície realmente possui
- trate loading, vazio, erro, retry e reentrada como comportamento principal
- verifique o resultado no mesmo contrato que o usuário consegue observar
Casos de borda de App desktop
A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.
Setup nativo em Go
A build 7.85 inclui executáveis de instalação Windows separados para Giorgio Desktop e Giorgio Code. Eles são PE32+ x86-64 com cabeçalho MZ, instalam launchers em LocalAppData e criam atalhos. O launcher usa Edge/Chrome em modo app quando disponível, sem empacotar outro Chromium.
