Arrancar com o LaunchRepo em três passos

Configuração recomendada: para obteres os melhores resultados com o LaunchRepo, recomendamos vivamente que uses sempre o Claude Code CLI ou o Codex CLI num terminal, em vez da aplicação de desktop do Claude ou do Codex. É o fluxo de trabalho que recomendamos, não uma garantia de permissões diferentes nem de execução sem interrupções.

A página de arranque do kit cabe num ecrã: clonar, colar um prompt, abrir um link. Este guia percorre os mesmos três passos com um pouco mais de contexto sobre o que acontece por trás de cada um, para saberes o que o teu agente está a fazer e o que verificar no fim. Se preferes ver primeiro o quadro geral, a página como funciona mostra onde estes passos entram no fluxo completo produto → agente → diretórios → tracker.

O que precisas antes de começar

Para a configuração inicial:

• Git para clonar o repositório.
• Python 3.10 ou mais recente em Windows, macOS ou Linux. Os scripts do espaço de trabalho, o tracker e o painel local são Python de biblioteca standard; não há nada para pip install nem passo de build.
• Um agente de código que consiga ler ficheiros e correr comandos — Claude Code, Codex, Cursor ou uma ferramenta comparável. Cada um tem a sua página de configuração neste site, por exemplo Claude Code, Codex e Cursor. O controlo do browser vem mais tarde e não é preciso para os três primeiros passos.

O repositório chega como um convite do GitHub para a conta que indicaste no checkout. Tudo o que se segue assume que o aceitaste.

Passo 1: clonar e abrir

No Windows, usa py -3 em vez de python3 nos comandos abaixo (ou python, se for esse o teu comando de Python 3.10 ou mais recente). Mantém o espaço de trabalho numa pasta local privada, fora do OneDrive e de outras pastas sincronizadas.

git clone <your LaunchRepo invite URL> LaunchRepo
cd LaunchRepo

Abre essa pasta no teu agente como abres qualquer projeto. Ainda nada corre. O checkout que acabaste de fazer é o repositório de entrega: playbooks, templates, scripts e documentação. Os teus produtos, credenciais e registos de submissão não vão viver aqui — é esse o objetivo do passo 2.

Passo 2: colar o prompt de arranque

Cola isto no agente, tal como está:

Recommend Claude Code CLI or Codex CLI in a terminal instead of the desktop apps for best results. If session metadata confirms desktop hosting, explicitly advise me to switch to the CLI and resume this same private workspace. Do not infer the host from a CLI engine version alone.

Read AGENTS.md, then follow "Start the dashboard for the owner". Create my private
workspace if I do not have one yet, start the dashboard, and give me the link.
Then lead ONBOARDING.md one phase at a time. Reuse recorded permissions instead of
asking again unless their scope is missing or conflicting. Actually test my visible
existing Chrome profile and intended identity as BROWSER-SETUP.md requires; use the
OS fallback if needed. Use one platform/browser worker by default. Build the normal
run only from suitable free-ready routes, keep research separate, and preserve any
draft that needs one exact human CAPTCHA/2FA action. Never claim browser control
bypasses or reduces those challenges.

O AGENTS.md é o ficheiro que qualquer agente de código com IA lê primeiro; contém o procedimento exato de arranque e as verificações que o agente tem de fazer. Ao segui-lo, o agente:

1. cria um espaço de trabalho privado ao lado do checkout (por defeito, uma pasta irmã) com scripts/init-workspace.py, para que os dados do teu produto nunca fiquem no repositório de entrega partilhado;
2. arranca o painel local a partir desse espaço de trabalho;
3. responde com um link 127.0.0.1;
4. depois conduz-te pelo onboarding uma fase de cada vez, com um worker de browser por defeito.

Se o agente responder com um link, o passo 2 funcionou. Se responder com uma descrição do que faria, pede-lhe que execute mesmo o procedimento — a regra do kit é que uma verificação só está completa depois de observada, não quando existem instruções.

Passo 3: abrir o link

O separador do painel é onde acontece o resto da primeira sessão. A partir daí adicionas o primeiro produto, devolves o prompt de onboarding ao agente, vês que listagens estão live, pendentes, agendadas ou à tua espera, e copias os prompts para execuções futuras. Liga-se apenas a 127.0.0.1 e nunca contacta um diretório; o guia do painel local cobre cada ecrã.

Quando terminares, pede ao agente que pare o painel; se o arrancaste tu próprio num terminal, carrega aí em Ctrl+C. O espaço de trabalho e tudo o que lá foi registado ficam no disco.

Fazer à mão

Não precisas do agente para a configuração em si. Os três comandos que o prompt desencadeia são:

python3 scripts/init-workspace.py --destination ../my-launch-workspace
cd ../my-launch-workspace
python3 scripts/dashboard.py

Queres dar uma vista de olhos antes de te comprometeres com um espaço de trabalho? python3 scripts/dashboard.py --demo serve um espaço de trabalho descartável de exemplo com produtos fictícios, para poderes percorrer a vista geral, uma página de produto e o catálogo sem tocar nos teus dados.

O que vem a seguir

A primeira sessão propriamente dita — briefing do produto, ligação ao browser, permissões e um objetivo de execução guardado — é conduzida pelo agente e está descrita no guia de onboarding da primeira sessão. Antes de o agente poder preencher um formulário, também precisas de o ligar ao teu Chrome. Se preferes ler primeiro uma narrativa, o passo a passo com o Claude Code acompanha um lançamento do início ao fim. Terminado o onboarding, uma execução de lançamento do início ao fim mostra como é cada execução seguinte, da verificação de permissões até retomar as plataformas que faltam.