Editar vídeos

O motor de edição do Neuro Harness é o neuro-mv-edit 1.8.0, instalado como plugin do perfil neuro. Esta página mostra como pedir uma edição no painel, o que o agente faz em cada etapa e os comandos que você mais vai ver nas sessões. A referência completa de comandos fica no repositório do neuro-mv-edit (link no fim da página).

Antes de começar

Modelo configurado: pelo menos um provedor em Configurações → Modelos. Para a revisão dos quadros, prefira um modelo com entrada de imagem. Veja Provedores e chaves.
Vídeo na pasta de trabalho: coloque o bruto em ~/Neuro, por exemplo ~/Neuro/videos/bruto.mp4. As sessões gravam nessa pasta sem pedir aprovação.
Ambiente conferido: numa sessão, peça para rodar neuro-mv-edit verify. Ele confere o FFmpeg, o Node.js, o Python, o HyperFrames, o motor Remotion e o Chrome, e baixa as fontes que faltarem.

Pedir uma edição

No Neuro Harness, a skill é chamada com /neuro-mv-edit seguido do pedido. Um pedido de edição em linguagem natural também ativa a skill. Não há comandos /neuro-mv-edit:editar nem subagentes próprios no Harness: esses atalhos são do plugin para Claude Code.

Abra uma sessão nova no painel.

Faça o pedido com o vídeo, o perfil e a rede:

/neuro-mv-edit edite videos/bruto.mp4 com o perfil <perfil> para o Reels

Acompanhe a sessão. O agente cria o projeto, transcreve, corta, monta as cenas, trata o som e faz o render.
Aprove as ações que o painel pedir, como gravar um perfil novo em ~/.neuro-mv-edit.

Outros pedidos que funcionam:

/neuro-mv-edit liste os perfis, temas e estilos disponíveis

/neuro-mv-edit crie um perfil para a Dra. Ana (saúde, @dra.ana), tema clean_paper, estilo educativo_claro

/neuro-mv-edit processe videos/aula.mp4 com o perfil <perfil> no formato TikTok, motor hyperframes

O que acontece numa edição

Etapa	Comando	Resultado
1. Projeto	`projeto init`	Mezanino CFR, tema, layout pelo topo da cabeça e `neuro.json`, em `projetos/<nome>`
2. Transcrição	`projeto transcrever`	`assets/transcript.json`, palavra a palavra (Whisper, em português, rodando localmente)
3. Legendas	`projeto legendas --apply-glossary`	Transcript corrigido pelo glossário do perfil e pela memória; legendas e SRT
4. Decupagem	`projeto cortar`	`edl.json`: silêncios confirmados pelo FFmpeg, respiros, claquetes e trechos removidos
5. Cenas	`cues.json` e `projeto build`	Cartões, câmera, SFX, trilha, efeitos e B-roll nas camadas do motor
6. Acompanhamento	`projeto estudio`	Studio no navegador. O que você muda lá volta para o projeto
7. Conferência	`projeto check` e `projeto snapshot`	Avisos de zona segura, legenda e SFX, e um PNG por cena
8. Render e master	`projeto render` e `projeto master`	`renders/master/<NOME>_MASTER.mp4`, com loudness EBU R128 em −14 LUFS
9. Metadados e copy	`metadata`	Tags no MP4 e a copy de postagem em `<vídeo>_COPY_POSTAGEM.md`
10. Entrega	`organize`	Cópia para `entregas/AAAA-MM/DD/<rede>/`: vídeo, cópia leve, relatório e copy
11. Aprendizado	—	Correções que você pedir para valer nos próximos vídeos vão para `~/.neuro-mv-edit/memory.json`

Cada perfil tem regras do setor (advocacia, educação, saúde ou geral). Elas valem na copy de postagem, na decupagem (ressalvas, negativas, números e nomes de lei não são cortados) e na revisão.

Acompanhar no Studio

Peça ao agente para abrir o Studio, ou para rodar neuro-mv-edit projeto estudio -P projetos/<nome>.

Remotion: abre o Remotion Studio numa porta livre a partir da 3000 e liga um vigia que sincroniza as suas edições com o projeto.
HyperFrames: abre o hyperframes preview.
No app desktop: o endereço local do Studio abre dentro do app.

O projeto está sempre salvo. Cada ação faz um checkpoint git local, e o Studio grava cada edição direto nos arquivos. O build não sobrescreve uma edição feita no Studio que ele não sabe representar.

Desfazer uma edição

neuro-mv-edit projeto historico -P projetos/<nome>
neuro-mv-edit projeto voltar <ref> -P projetos/<nome>

O voltar faz um checkpoint antes de restaurar, então dá para desfazer a restauração.

Escolher o motor

O motor de cada projeto vem, nesta ordem, da opção --engine, da variável NEURO_ENGINE, do engine_default do perfil ou, por padrão, do Remotion.

	Remotion (padrão)	HyperFrames
Edição	Camadas editáveis no Remotion Studio	Cenas HTML ajustáveis no preview
Cortes	Clipes não destrutivos	O FFmpeg monta `assets/base_cortado.mp4`
Licença	Grátis para pessoa física, empresas com até 3 pessoas e ONGs; Company License a partir de 4	Apache-2.0

Os dois usam os mesmos comandos de projeto e os mesmos 7 templates de cena: hook, stat, quote, contrast, checklist, timeline e cta. No Remotion, uma cena pode ser renderizada pelo HyperFrames e entrar na timeline.

Perfis, temas e estilos

Item	O que define
Perfil	O apresentador: tema, estilo, plataforma, motor, legenda, tom, CTA, metadados e regras do setor
Tema	Cores e fontes dos cartões
Estilo	O ritmo: cortes, legenda, câmera e volume dos SFX e da trilha

Onde ficam os seus: em ~/.neuro-mv-edit/perfis/, temas/ e estilos/. Eles sobrevivem às atualizações.
Mesmo id de um preset: o seu item passa a valer no lugar do preset.
Temas prontos: noticia_impacto, editorial_noir, clean_paper, tech_neon, corporativo_azul, educacao_vibrante, luxo_minimal e agro_terra.

Estilo	Ritmo
`dinamico_reels`	Cortes secos nos respiros, legenda de 3 palavras, punch-ins marcados
`editorial_sobrio`	Pausas preservadas, câmera quase parada, SFX discretos
`educativo_claro`	Legenda karaokê, respiros naturais, cenas didáticas mais longas
`comercial_acelerado`	Cortes muito secos, câmera forte, SFX presentes
`documental_calmo`	Pausas longas, legenda de até 5 palavras, quase sem punch-in

Para criar um perfil, peça no chat. O agente faz as perguntas e grava com neuro-mv-edit perfil novo --json. Gravar em ~/.neuro-mv-edit pede a sua aprovação no painel.

Plataformas

Plataforma	Id (`--platform`)	Rede (`organize -n`)	Resolução
Instagram Reels	`instagram_reels`	`reels`	1080×1920 (9:16)
TikTok	`tiktok`	`tiktok`	1080×1920 (9:16)
YouTube Shorts	`youtube_shorts`	`shorts`	1080×1920 (9:16)
YouTube 16:9	`youtube_horizontal`	`youtube`	1920×1080
Feed retrato	`instagram_feed_portrait`	`feed`	1080×1350 (4:5)

Nos formatos 9:16, os gráficos ficam acima da cabeça do apresentador, dentro da zona segura de cada rede.

Som

Os efeitos e a trilha vêm do servidor MCP oficial do ElevenLabs. Para ver como ligar o servidor, peça para rodar neuro-mv-edit mcp. Sem o ElevenLabs, o build avisa que os SFX estão faltando.

Comandos mais usados

Nas sessões do Neuro Harness, o comando neuro-mv-edit já está no PATH e aponta para o motor fixado. O agente roda estes comandos por você; eles também aparecem no histórico da sessão.

Comando	O que faz
`neuro-mv-edit info`	Lista perfis, temas e estilos, os da skill e os seus
`neuro-mv-edit perfil listar` · `mostrar <id>`	Lista os perfis ou mostra um inteiro
`neuro-mv-edit perfil novo --json <arquivo>`	Cria um perfil a partir de um JSON
`neuro-mv-edit tema preview <id>`	Gera a prévia HTML do tema em `~/.neuro-mv-edit/previews/<tema>/`
`neuro-mv-edit projeto init -p <perfil> -v <vídeo> -o <pasta>`	Cria o projeto
`neuro-mv-edit projeto cortar -P <pasta> --dry-run`	Mostra os cortes sem aplicar
`neuro-mv-edit projeto cortar -P <pasta> --manter a-b`	Protege um trecho, em segundos da fonte
`neuro-mv-edit projeto build -P <pasta>`	Gera o projeto do motor
`neuro-mv-edit projeto estudio -P <pasta>`	Abre o Studio (`--parar` fecha)
`neuro-mv-edit projeto render -P <pasta>`	Renderiza o vídeo final
`neuro-mv-edit projeto master -P <pasta> --name <NOME>`	Faz o master de loudness
`neuro-mv-edit projeto status -P <pasta>`	Motor, duração, cortes, Studio e último checkpoint
`neuro-mv-edit verify`	Confere o ambiente e baixa as fontes

-P <pasta> escolhe o projeto. Sem ele, vale a pasta atual.
Opções do motor vão depois de --, por exemplo projeto snapshot -P <pasta> -- --at 3.5.

Para usar outra versão do motor nas sessões, veja neuro-harness engine. Os arquivos de um projeto estão em Pastas e arquivos.

Referência completa

Referência de comandos do neuro-mv-editTodos os comandos e opções, com padrões e valores aceitos. Repositório privado: abre para contas com acesso.