Remocn/remocn

Passagem para o Remocn Studio

O Remocn Studio (https://remocn.studio) é um aplicativo desktop para macOS e Linux. Ele pré-visualiza um projeto Remotion ao vivo, permite que o usuário ajuste elementos manualmente e exporta mp4. Ele só abre pastas que reconhece, então um projeto passa por Prepare uma vez e pode ser Aberto a qualquer momento.

O script auxiliar é ${CLAUDE_SKILL_DIR}/scripts/studio.mjs (fora do Claude Code: scripts/studio.mjs ao lado deste arquivo). Ele precisa apenas do Node e imprime um único objeto JSON por comando. Execute-o a partir da raiz do projeto Remotion, ou passe a raiz como primeiro argumento.

Preparar

node "${CLAUDE_SKILL_DIR}/scripts/studio.mjs" init <raiz-do-projeto> --name "<nome do vídeo ou produto>"

O que ele faz e o que dizer ao usuário:

• Escreve .remocn/project.json (o manifesto do projeto do Studio: um projectId novo, revision: 0, sem marca) se ele não existir. Um manifesto existente nunca é tocado: seu projectId é a identidade do projeto no Studio.
• Coloca a varredura do Studio em src/videos/registry.tsx se estiver faltando e envolve a raiz no ponto de entrada como registerRoot(withVideos(Root)). A partir de então, todo src/videos/<slug>/index.tsx que exportar meta é uma composição com id <slug>, tanto no Remotion Studio quanto no Remocn Studio. As composições próprias do usuário em Root.tsx continuam funcionando.

Em um projeto que o usuário já tinha, pergunte antes de executá-lo: ele edita o ponto de entrada (uma importação, um encapsulamento) e adiciona dois arquivos.

Se o resultado disser ok: false com um motivo relacionado ao ponto de entrada, o ponto de entrada não chama registerRoot(Root) exatamente uma vez após suas importações. Faça o encapsulamento manualmente: adicione import { withVideos } from "<especificador-do-registro>"; usando o specifier do resultado (ele é relativo ao ponto de entrada, ex.: ../src/videos/registry para remotion/index.ts), e altere a chamada para registerRoot(withVideos(Root)). Se isso não for possível, explique o motivo ao usuário.

Em seguida, verifique se npx remotion compositions lista todos os slugs de vídeo.

Abrir

Somente após o usuário dizer sim para abrir o projeto no Studio:

node "${CLAUDE_SKILL_DIR}/scripts/studio.mjs" open <raiz-do-projeto>

Repasse a message do resultado. Conforme action:

• deep-link: O Studio está abrindo o projeto e mostra uma caixa de diálogo de confirmação. Nada mais a fazer.
• launched: O Studio está iniciando, mas não pode ser informado qual pasta abrir ainda. Diga ao usuário para escolher Open Folder (⌘O no macOS, Ctrl+O no Linux) e selecionar a raiz do projeto, e forneça o caminho.
• not-installed: forneça o link de download (https://remocn.studio) e os mesmos passos de Open Folder após a instalação.
• unsupported-platform: O Studio não é executado neste sistema operacional. O vídeo ainda pode ser pré-visualizado com npx remotion studio e renderizado com npx remotion render <slug>.

Se o resultado disser que o manifesto está faltando, execute Preparar primeiro.

Para verificar se o Studio está instalado sem abrir nada, execute o comando detect.

Não fazer

• Não crie .remocn/project.json manualmente nem copie um de outro projeto. Dois projetos com o mesmo projectId colidem no Studio, e ele recusa o segundo.
• Não mova vídeos para fora de src/videos/<slug>/. O Studio identifica um vídeo pelo nome de sua pasta.
• No claude.ai ou ChatGPT não há um projeto local para passar. Direcione o usuário para um agente de codificação (Claude Code, Codex) com este plugin, ou para os modelos próprios do Remocn Studio.