reelstyles/reelstyles-setup

Configuração do ReelStyles

Os scripts estão em setup/ na raiz do repositório ReelStyles (duas pastas acima deste arquivo): setup/setup.sh (macOS, Linux, WSL, Git Bash) e setup/setup.ps1 (Windows PowerShell). Eles aceitam os mesmos comandos. Abaixo, SETUP significa:

• macOS / Linux / WSL / Git Bash: bash <repo>/setup/setup.sh
• Windows PowerShell: powershell -ExecutionPolicy Bypass -File <repo>\setup\setup.ps1

Execute os comandos a partir da pasta de projeto do usuário (a pasta onde ele deseja a conexão do agente), não de dentro do repositório ReelStyles, a menos que seja a única pasta que ele use.

1. Detectar o sistema. Descubra o SO (Windows, macOS, Linux, WSL) e escolha o script correspondente. No Windows, prefira setup.ps1 a menos que você já esteja no Git Bash ou WSL.
2. Verificar. Execute SETUP check. Ele lista Node.js ≥ 22, ffmpeg + ffprobe, git, espaço em disco livre e Chrome para HyperFrames, e sai com código diferente de zero se algo obrigatório estiver faltando. Se exibir READY, vá para o passo 4.
3. Instalar o que está faltando, com a permissão do usuário.
   • Execute SETUP install --dry-run. Ele imprime, para cada ferramenta ausente, o comando exato que executaria (winget, Homebrew, apt ou dnf; Node via fnm, nvm ou o instalador oficial do nvm quando o Node do sistema for antigo).
   • Mostre ao usuário cada comando e pergunte quais devem ser executados. Nunca instale nada que o usuário não tenha autorizado, e informe claramente quando um comando usar sudo.
   • Execute SETUP install --yes <ferramenta> [<ferramenta>...] apenas com as ferramentas que o usuário autorizou (ou deixe o usuário executar SETUP install diretamente: ele pergunta por ferramenta). Se um comando precisar de senha, peça ao usuário para executá-lo no próprio terminal.
   • Node ou git instalados agora podem precisar de um novo terminal para estarem no PATH. Em seguida, execute SETUP check novamente até exibir READY.
4. Conectar o agente. Execute SETUP wire list para ver quais agentes foram detectados, informe o usuário, depois SETUP wire auto (ou SETUP wire <agente> para os que o usuário nomear: claude codex cursor roo cline gemini copilot windsurf). Ele escreve arquivos de ponte curtos no projeto (por exemplo .cursor/rules/reelstyles.mdc, .roo/rules/reelstyles.md, um bloco AGENTS.md) que informam ao agente onde está a skill ReelStyles. Nunca copia os kits. Adicione --global se o usuário quiser em todos os projetos. Usuários do Claude Code que instalaram o plugin não precisam de conexão.
5. Teste de fumaça. Execute SETUP test. Ele renderiza um filme de teste de 5 segundos e imprime o caminho do mp4 e o tempo de renderização. Informe ambos ao usuário. Se falhar, execute SETUP check, corrija o que ele listar e tente novamente.
6. Finalizar com: "ReelStyles está pronto: peça-me um vídeo em qualquer estilo dos STYLES.md" (skills/reelstyles/STYLES.md).

Notas

• Nada aqui envia dados para lugar nenhum: a telemetria do HyperFrames é desligada pelos scripts. A primeira execução baixa o pacote npm do HyperFrames e seu Chrome headless.
• Os scripts são seguros para executar novamente; eles pulam o que já foi feito.