🎬 Neuro MV Edit — Sistema Audiovisual & Motion Graphics (v1.10.0)

imageversion imageLicense: MIT imageElevenLabs MCP imageHyperFrames imageRemotion imagePlatforms

Pós-produção e motion graphics de alta retenção, feitos por agentes de IA. Você entrega o vídeo bruto e o perfil do apresentador, e o neuro-mv-edit cuida do resto: decupagem, cortes, legendas pt-BR, cenas animadas, câmera, sound design com o ElevenLabs, master de loudness, metadados no MP4, copy de postagem e arquivamento da entrega.

• Dois motores à escolha: Remotion (padrão), com o Studio aberto no navegador e o projeto sempre salvo, e HyperFrames. Os dois podem ser combinados por cena.
• Formatos e redes: Reels, TikTok, Shorts, YouTube 16:9 e Feed.
• Segmentos: jurídico, automotivo, educação, saúde e vendas.

Sumário:

• Primeiros passos: Início rápido · Instalação
• Uso: Claude Code · Outros agentes · O que acontece numa edição
• Recursos: Motores · Biblioteca · Comandos · ElevenLabs · Plataformas · Compliance
• Manutenção: Atualização · Desinstalação · Problemas · Estrutura · Releases · Privacidade

Todos os comandos e opções, um por um, estão em docs/COMANDOS.md.

Início rápido

1. Instale:

npx --yes github:monrars1995/oneuros-mv-edit#v1.10.0

O assistente:

• detecta os agentes da máquina e pergunta em quais instalar;
• instala o motor e as fontes;
• oferece criar o primeiro perfil.

2. No Claude Code, abra uma sessão nova e rode:

/neuro-mv-edit:setup
/neuro-mv-edit:perfil novo
/neuro-mv-edit:editar videos/IMG_1266.MOV exemplo_juridico

• setup confere o ambiente e lembra de autorizar o ElevenLabs em /mcp.
• perfil novo cria o perfil do cliente com perguntas no chat. Pule este passo se o perfil já existe.
• editar faz o vídeo inteiro e para três vezes para você aprovar: os cortes, as cenas e a revisão final.

3. Em outro agente (Codex, Hermes, OpenCode, Open Design, Neuro Harness, Gemini, Cursor), peça em linguagem natural: veja Usando em outros agentes.

Instalação

Requisitos

O verificar --corrigir confere tudo isso pelas decisões da edição (resolução, codec, motor) e instala o que faltar, inclusive as fontes (veja Fontes).

Instalar

Fixe sempre a tag (#vX.Y.Z): o npx guarda em cache o que já baixou. A lista de opções está em docs/COMANDOS.md.

Onde cada agente recebe o neuro-mv-edit

O padrão é plugin em todo agente que tem sistema de plugin. Os outros recebem a pasta da skill.

• Trocar de modo:

  • para plugin: sai a cópia avulsa da skill daquele agente;
  • para skill: o plugin dele é desinstalado.

  Assim a skill nunca carrega duas vezes.

• --skills-only vale para o Claude Code, o Hermes, o OpenCode e o Neuro Harness. O Open Design é sempre plugin.

• Codex com muitas skills: o Codex mostra ao modelo só parte da lista. A skill continua carregada: chame com $neuro-mv-edit.

• Hermes: a skill do plugin ganha um namespace (agent-plugin-neuro-mv-edit-<hash>:neuro-mv-edit). O aviso "Skipped Node deps" é inofensivo.

• Open Design:

  • o app precisa estar aberto;
  • o instalador usa a pasta local, e o plugin entra como confiável;
  • se o plugin vier do GitHub (só com o repositório público), conceda as capacidades: od plugin trust neuro-mv-edit --capabilities bash,network,fs:read,fs:write.

• Neuro Harness:

  • é detectado pelo perfil ~/.neuro-harness/dsh/profiles/neuro (ou ~/.neuro-mv-superagent/…, o nome antigo). Outra pasta ou outro perfil: NEURO_HARNESS_HOME e NEURO_HARNESS_PROFILE;
  • o instalador roda dsh plugin --profile neuro add <origem> com o dsh do runtime do Harness e DSH_HOME=<pasta>/dsh. A origem é a tag no GitHub (github:monrars1995/oneuros-mv-edit#vX.Y.Z) ou, de um clone, link:<clone>;
  • o plugin registra a skill e põe o comando neuro-mv-edit no PATH das sessões. Depois de instalar, reinicie o Harness (neuro-harness restart);
  • em modo skill, o Harness lê ~/.agents/skills, a mesma cópia do Codex. Por isso o instalador nunca apaga essa pasta pelo neuro-harness;
  • uma cópia em ~/.agents/skills ou em ~/.neuro-harness/dsh/skills tem precedência sobre a skill do plugin no Harness. O status --deep avisa quando a versão dela é outra.

Conferir

npx --yes github:monrars1995/oneuros-mv-edit#v1.10.0 status --deep

O status --deep mostra, por agente, onde o neuro-mv-edit está, a versão e o modo. Ele também pergunta ao próprio agente se carrega a skill: Claude Code (skills, comandos, subagentes e MCP do plugin), Codex, Hermes, Open Design e Neuro Harness (versão do dsh, origem do plugin e se está ativo no perfil).

Depois de instalar ou atualizar, abra uma sessão nova de cada agente.

Instalação manual dos plugins

Se preferir instalar sem o instalador:

O SHA da tag sai de git ls-remote https://github.com/monrars1995/oneuros-mv-edit 'refs/tags/vX.Y.Z^{}' (troque X.Y.Z pela versão).

Usando no Claude Code

O plugin traz:

• a skill;
• 9 comandos;
• 2 subagentes;
• um hook de início de sessão (lembra as decisões de exportação e o estado da última verificação);
• o servidor MCP do ElevenLabs;
• o comando neuro-mv-edit no PATH.

Ele funciona no Claude Code do terminal, na aba Code do app desktop e no VS Code. Não instala no claude.ai nem no Cowork, que não aceitam plugins com executáveis e não têm ffmpeg nem Remotion locais.

Comandos

• A skill sozinha: /neuro-mv-edit:neuro-mv-edit. Ela também é ativada sozinha quando o pedido é de edição de vídeo.
• Sem pasta nos argumentos: os comandos de projeto usam a pasta atual (se tiver neuro.json) ou o projeto mais recente em projetos/.

Dois nomes iguais, duas coisas diferentes.

• /neuro-mv-edit:status mostra um projeto. neuro-mv-edit status mostra a instalação nos agentes.
• /neuro-mv-edit:setup confere o ambiente. neuro-mv-edit setup é o instalador dos agentes, rodado no terminal.

Como o /neuro-mv-edit:editar trabalha

1. Perfil e motor.
   • Sem perfil nos argumentos, ele lista os perfis e pergunta qual usar.
   • O motor é o do perfil; se o perfil não define, Remotion.
2. Projeto. Mede o topo da cabeça num quadro do vídeo e cria o projeto em projetos/<nome>.
3. Transcrição e legendas. Mostra os termos suspeitos e corrige com o glossário do perfil. As correções que você pedir para valer nos próximos vídeos vão para a memória.
4. Decupagem.
   • Calcula os cortes de silêncio e pede ao decupador as tomadas repetidas e as claquetes.
   • Para você aprovar os cortes.
5. Cenas.
   • Escreve o cues.json e gera o projeto.
   • Abre o Studio e mostra a URL.
   • Roda check e snapshot e confere os PNGs.
   • Para você aprovar as cenas. Ajuste no Studio ou peça no chat.
6. Som.
   • Gera os efeitos que faltam com o ElevenLabs e, se o perfil pede, a trilha.
   • Abaixa a trilha sob a fala.
7. Render, master e revisão.
   • Renderiza e faz o master de loudness.
   • Pede ao revisor o checklist de entrega.
   • Para você aprovar a revisão.
8. Entrega. Grava os metadados, a copy e a pasta da entrega (/neuro-mv-edit:entregar).

O projeto está sempre salvo:

• toda ação faz um checkpoint git local;
• o Studio grava cada edição direto nos arquivos.

Para desfazer: neuro-mv-edit projeto historico -P projetos/<nome> e neuro-mv-edit projeto voltar <ref> -P projetos/<nome>.

Subagentes

• Os dois só leem: não alteram o projeto.
• O /editar chama os dois sozinho.
• Para chamar à mão: @agent-neuro-mv-edit:revisor projetos/cpr.

O comando neuro-mv-edit nas sessões

Enquanto o plugin está ativo, o comando neuro-mv-edit fica no PATH das sessões do Claude Code (e do Neuro Harness, com o plugin dele). O agente roda neuro-mv-edit perfil listar ou neuro-mv-edit projeto build -P projetos/cpr sem npx e sem rede.

Fora dessas sessões (num terminal comum ou em outro agente), use npx --yes github:monrars1995/oneuros-mv-edit#v1.10.0 <comando>.

ElevenLabs no plugin

O plugin já traz o servidor https://api.elevenlabs.io/v1/mcp. Autorize uma vez: numa sessão, digite /mcp, escolha o elevenlabs e faça o login no navegador. Não precisa de claude mcp add.

Se você já tinha o mesmo endereço configurado, o Claude Code mantém uma conexão só.

Exemplo de sessão

você  › /neuro-mv-edit:editar gravacoes/cpr_prazo.mov exemplo_juridico
agente› Projeto criado em projetos/cpr_prazo (Remotion, Reels, cabeça em y=560).
        Termos suspeitos no transcript: "exédulas" → "cédulas"? …
agente› Cortes propostos: 14 silêncios (6,2 s) + 2 tomadas repetidas (decupador). Aprova?
você  › aprovo, mas mantenha 40–44 s
agente› Studio aberto em http://localhost:3000 — 7 cenas, PNGs revisados. Aprova as cenas?
você  › troque a cena 3 por um checklist
agente› … revisor: pronto para entregar. Master −14,0 LUFS. Entrega em entregas/2026-11/07/reels/

Usando em outros agentes

Peça em linguagem natural. O agente lê a skill e usa o CLI pelo npx, porque o comando neuro-mv-edit só fica no PATH nos plugins do Claude Code e do Neuro Harness.

Exemplos de pedido:

$neuro-mv-edit edite videos/IMG_1266.MOV com o perfil exemplo_juridico para o Reels

Use a skill neuro-mv-edit: processe gravacoes/aula.mp4 com o perfil exemplo_educacao no formato TikTok, motor hyperframes

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

O ElevenLabs nesses agentes precisa ser configurado à mão: veja ElevenLabs.

O que acontece numa edição

Exportação em 4K sem perder qualidade

Você decide antes da edição, e a decisão vale do mezanino ao master:

neuro-mv-edit exportacao analisar bruto.mov --plataforma instagram_reels   # o que a fonte rende e a recomendação
neuro-mv-edit projeto init -p exemplo_educacao -v bruto.mov -o projetos/aula --resolucao 4k,1080p --codec h264
neuro-mv-edit projeto render -P projetos/aula        # uma versão nativa por resolução
neuro-mv-edit projeto master -P projetos/aula --name AULA

O que garante a qualidade:

• Supersampling, não ampliação. A composição fica nas coordenadas do layout (zonas seguras e legendas iguais) e o render desenha cada quadro direto na resolução final: texto e gráficos são vetor e saem nítidos em 4K.
• O vídeo da fonte não é reduzido antes da hora. O mezanino guarda a área útil da fonte até a maior saída; quando precisa recodificar (HEVC/ProRes/10-bit do celular, fps, grade do perfil, HDR), usa H.264 CRF 10, visualmente sem perda.
• Uma codificação só. PNG por quadro no render e o codec escolhido no fim, com bt709 marcado. O master só ajusta o áudio; o vídeo é copiado.
• Sem promessa falsa: um 4K horizontal rende só 1215x2160 num Reels 9:16. O analisar e o init avisam quando uma resolução amplia o vídeo e recomendam a maior que não amplia.

Motores de edição

Cada projeto escolhe o motor no init:

1. a opção --engine remotion|hyperframes;
2. senão, a variável NEURO_ENGINE;
3. senão, o engine_default do perfil;
4. senão, remotion.

Os dois usam os mesmos comandos (projeto …) e os mesmos 7 templates de cena.

• Os dois juntos: no Remotion, uma cena com "motor": "hyperframes" é renderizada pelo HyperFrames com alfa (ProRes 4444) e entra na timeline. Só o render final comprime em H.264.
• O papel do ffmpeg:
  • o mezanino (CFR, keyframes e grade de cor);
  • a fala montada a partir do EDL, com fades nas emendas;
  • o ducking da trilha por sidechain;
  • o master de loudness em 2 passagens.
• O build preserva o Studio: ele nunca sobrescreve uma edição feita no Studio que não sabe representar. Use --force para regerar mesmo assim.

Licença do Remotion

• Grátis: pessoa física, empresas com até 3 pessoas e ONGs.
• A partir de 4 pessoas (contando todo o pessoal): é preciso a Company License.
• Render feito por agente conta como automação.
• Chave: com REMOTION_LICENSE_KEY no ambiente, os renders usam a chave.
• Sem licença: use --engine hyperframes.

Mais detalhes:

• remotion/BRIDGE.md: o motor Remotion, o Studio e a sincronização.
• hyperframes/BRIDGE.md: o fluxo e o cues.json.
• TECNICAS.md: o padrão de acabamento.
• CENAS.md: as 25 funções de fala e o template de cada uma.

Biblioteca: perfis, temas e estilos

Um perfil define o apresentador:

• o tema, o estilo de edição e a plataforma;
• o motor;
• a legenda;
• o tom e o CTA;
• os metadados;
• as regras do setor.

Um tema define cores e fontes dos cartões. Um estilo define o ritmo: cortes, legenda, câmera e volume dos SFX e da trilha.

Onde ficam os seus

• Em ~/.neuro-mv-edit/{perfis,temas,estilos}/.
• Eles sobrevivem às atualizações.
• Um item seu com o mesmo id de um preset passa a valer no lugar dele.

Perfis que vêm com a skill

Os dois primeiros são exemplos para testar a skill. Perfis reais (de clientes ou da sua equipe) ficam na sua biblioteca: crie com perfil novo ou traga um pacote com perfil importar <pacote.json>. No Neuro Harness, o pacote privado da equipe é instalado depois do login.

Para ver um perfil inteiro: neuro-mv-edit perfil mostrar <id>.

Temas e estilos

• 8 temas prontos: noticia_impacto, editorial_noir, clean_paper, tech_neon, corporativo_azul, educacao_vibrante, luxo_minimal, agro_terra.
• Temas de marca: ficam na sua biblioteca (tema novo, ou vêm junto num perfil importar).
• 5 estilos: dinamico_reels, editorial_sobrio, educativo_claro, comercial_acelerado, documental_calmo.

Criar e editar

O que o perfil novo pergunta

• o perfil de partida, o nome e o id;
• o @, o cargo, o segmento e as regras do setor;
• o tema (dá para criar um na hora) e o estilo;
• a plataforma e o motor;
• a legenda: se queima no vídeo, a fonte, as cores e as palavras em destaque;
• o fade final, o tom, o CTA e os metadados.

Sem terminal (agentes e CI)

• Perfis: passe opções (--id, --nome, --tema…) ou --json.
• Temas e estilos: só --json.

Todas as opções estão em docs/COMANDOS.md.

Referência rápida de comandos

Prefixo:

• na sessão do Claude Code com o plugin: neuro-mv-edit;
• em outro lugar: npx --yes github:monrars1995/oneuros-mv-edit#v1.10.0;
• num clone: node cli/cli.js.

• -P <pasta>: escolhe o projeto. Sem ele, vale a pasta atual.
• Opções extras para o motor vão depois de --, ex.: projeto snapshot -P projetos/cpr -- --at 3.5.

A referência completa, com cada opção, valor padrão e valores aceitos, está em docs/COMANDOS.md.

ElevenLabs (sound design)

Nenhum cartão, título ou transição entra mudo. Os efeitos e a trilha vêm do servidor MCP oficial do ElevenLabs.

flowchart LR
    A["Agente de IA<br/>(Claude Code, Codex, Hermes, OpenCode, Gemini, Cursor…)"] --> B["ElevenLabs MCP"]
    B --> C["text_to_sound_effects<br/>(cliques, whooshes, impactos)"]
    B --> D["compose_music<br/>(trilha instrumental)"]
    B --> E["isolate_audio<br/>(limpeza de voz)"]
    C --> F["build: SFX no pico + ducking<br/>master −14 LUFS"]
    D --> F
    E --> F

• Nome do servidor: use elevenlabs. Os modelos prontos estão em mcp-config.json.
• Guia no terminal: neuro-mv-edit mcp.
• Sem ElevenLabs: o build avisa que os SFX estão faltando, e a skill sugere a /media-use do HyperFrames.

Fontes

O verificar --corrigir confere e baixa as fontes oficiais:

• macOS: em ~/Library/Fonts;
• Linux: em ~/.local/share/fonts (ou $XDG_DATA_HOME/fonts).

neuro-mv-edit verificar --corrigir

Plataformas e zonas seguras

Compliance por segmento

Cada perfil tem regras do setor (compliance_framework). Elas valem:

• na copy de postagem, que ganha a nota de conformidade;
• na decupagem: o decupador nunca propõe cortar ressalvas, negativas, números ou nomes de lei;
• na revisão do revisor.

Atualização

O caminho normal é rodar o instalador com a tag nova (a da release marcada como Latest):

gh release view --repo monrars1995/oneuros-mv-edit           # qual é a última versão
npx --yes github:monrars1995/oneuros-mv-edit#vX.Y.Z install   # atualiza todos os agentes detectados
npx --yes github:monrars1995/oneuros-mv-edit#vX.Y.Z status --deep

O que a atualização faz

• Claude Code: aponta o marketplace para a tag nova e atualiza o plugin.
• Hermes: reinstala o plugin no commit da tag.
• Neuro Harness: troca o plugin do perfil pela tag nova (dsh plugin add). Reinicie o Harness.
• Outros agentes: recria a pasta da skill.
• O que é seu não muda: tudo em ~/.neuro-mv-edit/ (perfis, temas, estilos, memória, prévias e o motor Remotion).

Depois, abra uma sessão nova de cada agente.

À mão, se você instalou os plugins sem o instalador

O claude plugin marketplace update sozinho não muda de versão: o marketplace está fixo numa tag, e o update só baixa a mesma tag de novo.

Desinstalação

npx --yes github:monrars1995/oneuros-mv-edit#v1.10.0 uninstall --dry-run          # mostra o que sairia
npx --yes github:monrars1995/oneuros-mv-edit#v1.10.0 uninstall                    # todos os agentes
npx --yes github:monrars1995/oneuros-mv-edit#v1.10.0 uninstall --agent hermes     # um agente
npx --yes github:monrars1995/oneuros-mv-edit#v1.10.0 uninstall --target .claude/skills   # instalação feita com --target

O uninstall remove a skill, os plugins e o marketplace do Claude Code. Ele nunca apaga um clone git nem uma pasta com outra skill de mesmo nome.

À mão

O que fica

• A pasta ~/.neuro-mv-edit/ continua: biblioteca, memória, prévias e o motor Remotion (~250 MB).
• Para apagar também, rode rm -rf ~/.neuro-mv-edit. Isso não tem volta.

Solução de problemas

Estrutura do repositório

O repositório segue o layout padrão de plugins: a skill fica em skills/neuro-mv-edit/, e cada plataforma tem um manifesto que aponta para ela.

neuro-mv-edit/
├── .claude-plugin/
│   ├── plugin.json                   # Plugin do Claude Code (versão única do plugin)
│   ├── marketplace.json              # Marketplace (claude plugin marketplace add monrars1995/oneuros-mv-edit#vX.Y.Z)
│   └── icon.png                      # Ícone do plugin
├── plugin.json                       # Plugin portátil Agent Plugins v1 (Hermes e outros)
├── plugins/opencode/                 # Plugin OpenCode V2 (server.js + package.json)
├── plugins/dsh/                      # Plugin do DeepSeek/Neuro Harness (index.js + cordis.patch.yml)
├── bin/neuro-mv-edit(.cmd)           # Comando no PATH das sessões do Claude Code e do Neuro Harness (chama cli/cli.js)
├── cli/
│   ├── cli.js                        # Roteador: setup, install, uninstall, status, agents, verify, mcp, info,
│   │                                 #   perfil, tema, estilo, projeto, remotion, hf, metadata, organize, version, help
│   ├── setup.js                      # Assistentes: setup (agentes), perfil, tema, estilo
│   ├── ui.js                         # Perguntas interativas sem dependências
│   ├── library.js                    # Presets da skill + ~/.neuro-mv-edit/{perfis,temas,estilos}
│   ├── agents.js                     # Agentes, caminhos e instaladores de skill e plugin
│   └── version.js                    # Versão única em todos os manifestos
├── commands/                         # /neuro-mv-edit:editar, perfil, tema, estudio, entregar, setup, status
├── agents/                           # Subagentes revisor e decupador
├── .mcp.json                         # ElevenLabs MCP do plugin
├── docs/COMANDOS.md                  # Referência completa de comandos e opções
├── skills/neuro-mv-edit/             # A SKILL (o que cada agente carrega)
│   ├── SKILL.md                      # Manual operacional da IA
│   ├── open-design.json              # Plugin do Open Design
│   ├── mcp-config.json               # Modelos de configuração do ElevenLabs MCP
│   ├── data/memory.json              # Glossários e memória base (só leitura)
│   ├── presets/                      # perfis, temas, estilos, plataformas e animações
│   ├── references/                   # remotion/, remotion-project/, hyperframes/, hyperframes-template/
│   └── scripts/                      # neuro_project.py, neuro_remotion.py, neuro_edl.py, hf_project.py,
│                                     #   neuro_preview.py, inject_metadata.py, organize_deliveries.py, verify-env.py
├── package.json                      # Executável do npx github:monrars1995/oneuros-mv-edit e manifesto `dsh` do plugin do Harness
├── CHANGELOG.md
├── LICENSE
└── README.md

Desenvolvimento e releases

Para testar a partir de um clone:

• node cli/cli.js <comando> roda o CLI do clone.
• claude --plugin-dir . abre uma sessão com o plugin do clone, sem instalar nada.
• claude plugin validate . confere os manifestos.

O projeto segue o Versionamento Semântico:

O histórico está no CHANGELOG.md. Cada versão tem uma tag vX.Y.Z e uma Release com o pacote da skill (neuro-mv-edit-skill-vX.Y.Z.zip).

Como publicar uma versão (mantenedores):

1. Grave a versão em todos os marcadores:
   • com uma ocorrência cada: os pacotes, os manifestos dos plugins, o SKILL.md, o CLI, a memória e o título e o selo do README;
   • em todas as ocorrências: as tags #vX.Y.Z do README, do SKILL.md e do docs/COMANDOS.md.

   npm run version:set X.Y.Z
   npm run version:check
   

2. Descreva as mudanças no topo do CHANGELOG.md, abra o PR e faça o merge na main.
3. Crie a tag e a Release marcada como Latest:

   git switch main && git pull
   git tag -a vX.Y.Z -m "vX.Y.Z" && git push origin vX.Y.Z
   mkdir -p dist && (cd skills && zip -rq ../dist/neuro-mv-edit-skill-vX.Y.Z.zip neuro-mv-edit -x '*.DS_Store' '*/__pycache__/*')
   gh release create vX.Y.Z dist/neuro-mv-edit-skill-vX.Y.Z.zip --latest --title "vX.Y.Z" --notes "<seção da versão no CHANGELOG>"
   

🔒 Privacidade

• O plugin e a skill não coletam nem enviam dados. Vídeos, transcrições, projetos, perfis e memória ficam no seu computador: na pasta do projeto e em ~/.neuro-mv-edit/.
• Serviços externos, usados sob pedido:
  • ElevenLabs (MCP do plugin): os textos dos efeitos e da trilha, e o áudio enviado para limpeza, vão para a ElevenLabs. Valem a política de privacidade da ElevenLabs e a sua conta.
  • Remotion: com REMOTION_LICENSE_KEY definida, o render informa o uso da licença à Remotion.
  • HyperFrames: a CLI tem telemetria anônima. Desligue com npx hyperframes telemetry disable ou HYPERFRAMES_NO_TELEMETRY=1.
• Downloads: a transcrição (Whisper) roda localmente. As fontes vêm do Google Fonts e do npm.

Autor e licença

Desenvolvido por Ramon Ribeiro (monrars1995). Licença MIT.

• GitHub: @monrars1995
• Instagram: @monrars e @goldneuron.io