> ## Documentation Index > Fetch the complete documentation index at: https://supastack.dev/llms.txt > Use this file to discover all available pages before exploring further. > For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt # Deixe um agente fazer a configuração Cole um prompt pronto em um agente de codificação, deixe-o executar a configuração Desktop no seu computador e verifique o relatório que ele escreve sobre cada etapa. ## Você pode delegar a parte chata Este repositório foi escrito para que um agente de codificação possa lê-lo. Ele traz um arquivo de mapa (`llms.txt`), um arquivo de regras (`AGENTS.md`), notas de memória por arquivo (`.ai/`) e skills de tarefas (`.agents/skills/`). O checkout Desktop independente não inclui a pasta `prompts/`, portanto o prompt pronto está impresso neste guia — copie-o abaixo em vez de abrir um arquivo. Delegar a digitação não significa pular as verificações. O agente trabalha dentro da sua cópia do repositório e precisa relatar o que fez com evidências. As seções abaixo mostram como é um bom relatório, para que você continue no comando do resultado. Este caminho configura o shell Tauri e sua conexão com o backend Web — o servidor que gerencia contas e dados. A janela desktop apenas exibe esse backend; se o seu checkout também contém apps/web, o agente pode executá-lo localmente, e um checkout somente Desktop precisa do endereço de backend acessível que lhe foi fornecido. [Execute o aplicativo Desktop manualmente em vez disso](https://supastack.dev/pt/docs/desktop/ship-in-5-minutes.md) ## O que você precisa primeiro Conclua primeiro o guia de preparação: Node.js, Git e um editor instalados, o convite do GitHub aceito e a pasta supastack baixada no seu computador. O agente trabalha dentro dessa pasta, então tudo em [Antes de começar](https://supastack.dev/pt/docs/desktop/before-you-start.md) continua valendo. Você também precisa de uma ferramenta que atue como agente de codificação — um editor com um agente de codificação de IA embutido (uma IDE de IA) ou um agente que roda no seu terminal (uma CLI de agente). Qualquer ferramenta atual com agente funciona; o prompt já detalha o que ele deve ler e executar, então você não precisa escrever as instruções. Por fim, decida duas coisas que o prompt pede: o endereço do backend que a janela deve carregar — http://localhost:3000 para um backend local ou seu endereço HTTPS fornecido — e se o Rust e as ferramentas de compilação nativas já estão instalados neste computador. ## Copie o prompt, preencha duas lacunas, cole O prompt é o bloco de código abaixo — selecione e copie o bloco inteiro. Dois placeholders precisam das suas escolhas. Substitua `` pelo endereço do backend que a janela deve carregar — http://localhost:3000 para um backend local ou seu endereço HTTPS fornecido. Substitua `` por present quando rustc e cargo já imprimem versões, ou install quando o agente deve primeiro instalar o Rust e as ferramentas de compilação do SO. As etapas numeradas permanecem exatamente como escritas. ``` Set up this supastack Desktop checkout end to end and open the Tauri window against the backend at ****. 1. Read llms.txt, AGENTS.md and docs/agent-security.md before changing anything. 2. Run rustc --version and cargo --version. On **** = install, install Rust and this OS's Tauri prerequisites first, then continue. 3. Run corepack pnpm install. 4. If apps/web exists in this checkout, start it in a second terminal; otherwise verify answers from this computer and report its status. 5. Start the shell with corepack pnpm --filter @supastack/desktop dev and report whether the window opens, the tray icon appears and the summon shortcut works. 6. Stop after any step fails twice and report the failing command and first error. Ask before deleting anything. ``` ## O que o agente faz com o prompt O prompt aponta o agente para o mapa, as regras e a checklist de segurança, e depois manda ele trabalhar na configuração em ordem e provar cada fase. Em termos simples, o agente: - Lê o mapa do repositório (`llms.txt`), as regras do projeto (`AGENTS.md`) e as regras de tratamento de credenciais (`docs/agent-security.md`) antes de tocar em qualquer coisa. - Verifica a toolchain Rust e os pré-requisitos do Tauri deste SO, e relata o que instala em vez de falhar no meio de uma compilação. - Verifica se o backend responde no seu endereço — iniciando o apps/web ele mesmo apenas quando essa pasta existe neste checkout — em vez de assumir um servidor que não existe. - Instala dependências, compila o shell e abre a janela, depois relata o comportamento da janela, bandeja e atalho de invocação com a saída real. - Para e relata depois que a mesma etapa falha duas vezes — ele não contorna uma falha nem exclui nada sem perguntar. ## O que você verifica no relatório do agente Um bom relatório mostra evidências, não afirmações. Procure a URL do backend respondendo, a instalação de dependências concluída, uma compilação Rust finalizada e uma janela aberta atrás de cada PASS — não uma frase como 'tudo funciona'. O prompt diz ao agente para parar e relatar depois que a mesma etapa falhar duas vezes — não para contornar a falha — e para perguntar antes de qualquer coisa destrutiva. Se o seu agente continuar improvisando após falhas repetidas, pare-o e leve o primeiro erro ao [guia de solução de problemas](https://supastack.dev/pt/docs/desktop/troubleshooting.md). Duas coisas nunca devem aparecer: um recurso de segurança desligado para silenciar um erro e um valor secreto, como uma senha ou chave, impresso no chat ou no relatório. Se vir qualquer uma delas, trate a execução como falha. Mantenha separados na sua mente o shell e o login real. A janela mostrando a página inicial do seu backend prova o shell — contas reais ainda precisam do banco de dados do backend. 'A janela abriu' ainda não é 'as contas funcionam'. ## Se você preferir fazer à mão Cada etapa que o agente executa está escrita nos guias manuais abaixo — os mesmos comandos, as mesmas verificações, no seu ritmo. [Execute o aplicativo Desktop em 5 minutos](https://supastack.dev/pt/docs/desktop/ship-in-5-minutes.md) [Leia a configuração completa do shell](https://supastack.dev/pt/docs/desktop/run.md) [Corrija uma falha de configuração](https://supastack.dev/pt/docs/desktop/troubleshooting.md) ## Seguinte [Inicie o app desktop em 5 minutos](https://supastack.dev/pt/docs/desktop/ship-in-5-minutes.md)