Enquanto vendema moldura, vocêtem o motor.

Pronto: o corte está em entrega/, com um ORIGEM.md dizendo de onde veio. Sem BRIEF, ele cai na pasta 00-sem-beat/.

ID=$(getbrolls search --provider nasa \
  --query "Artemis launch" --limit 1 \
  --project /caminho/meu-video | jq -r '.items[0].id')
getbrolls preview --candidate "$ID" --start 0 --end 4 \
  --project /caminho/meu-video

getbrolls status --project /caminho/meu-video \
  | jq -r '.summary.line, .summary.do.command'

O arquivo .env

Opcional. Fica em ~/.getbrolls/.env. Este é o arquivo de exemplo completo da 2.6, com todas as variáveis: tire o # só da linha que quiser mudar. Linha com # é comentário e não vale.

# ─────────────────────────────────────────────────────────────────────
# GET B-ROLLS — configurações
# ─────────────────────────────────────────────────────────────────────
# Tudo aqui é OPCIONAL. A skill funciona sem nenhum .env.
# English version: .env.example
#
# Como usar este arquivo
#   1. Copie para `$GB_HOME/.env` (padrão `~/.getbrolls/.env`), que vale
#      para qualquer instalação. Só UM `.env` é lido, nesta ordem:
#        `--env-file /caminho/do/.env`
#        > `GB_ENV_FILE` (só no ambiente do processo, nunca dentro de um `.env`)
#        > `.env` da pasta da instalação (checkout; continua valendo)
#        > `$GB_HOME/.env`
#      Dois `.env` nunca se misturam; o `doctor` mostra qual foi usado.
#      `GB_HOME` não pode ser definido dentro de `$GB_HOME/.env`.
#      `GB_PROFILE` e `GB_ENV_FILE` só no ambiente do processo: um `.env`
#      que os define é recusado. Um `getbrolls.toml` do workspace
#      (veja docs/MANUAL.md) perde para este arquivo, campo a campo.
#   2. Descomente só as linhas que você quer mudar.
#
# Regras do formato
#   - Um `CHAVE=valor` por linha. Aspas são opcionais: CHAVE="valor" funciona.
#   - Sem interpolação de variáveis e sem comandos de shell: `$HOME` e
#     `$(...)` NÃO são expandidos. Escreva o caminho completo.
#   - Variável já exportada no seu shell vence este arquivo.
#   - Chave desconhecida é erro: um erro de digitação aparece na hora,
#     em vez de ser ignorado em silêncio.
#   - Valor vazio (`CHAVE=`) significa "use o padrão".
#
# Nunca versione um `.env` real. Ele é ignorado pelo git; guarde suas chaves de API.
# Rode `python3 scripts/gb.py doctor` (no pacote instalado, `getbrolls doctor`) para
# ver o que está ativo e o que falta.


# ── Prévias ──────────────────────────────────────────────────────────
# O que quem revisa vê antes de qualquer coisa ser baixada por inteiro.

# Tipo de prévia.
#   gif     prévia animada do trecho, mais poster e contact sheet (padrão)
#   static  só poster e contact sheet, sem animação
GB_PREVIEW_MODE=gif

# O que o GIF anima.
#   broll   só o insert (padrão)
#   full    a composição fornecida deste insert
GB_GIF_SCOPE=broll

# Largura do GIF em pixels. Faixa: 160–720. Padrão: 360.
# Aumente para material com detalhe pequeno (tela, texto); diminua se as prévias pesarem.
GB_GIF_WIDTH=360

# Quadros por segundo do GIF. Faixa: 2–18. Padrão: 8.
GB_GIF_FPS=8

# Tamanho da paleta do GIF. Faixa: 32–256. Padrão: 128. Menos cores = arquivo menor.
GB_GIF_COLORS=128

# Tamanho máximo do GIF em MB. Faixa: 1–30. Padrão: 5.
GB_GIF_MAX_MB=5

# Trecho mais longo que um único `preview` aceita, em segundos. Faixa: 1–30. Padrão: 10.
# Candidatos mais longos precisam ser pré-visualizados em partes.
GB_PREVIEW_MAX_SECONDS=10

# Número de quadros do contact sheet. Faixa: 1–30. Padrão: 12.
GB_STATIC_FRAMES=12

# Teto do `preview --scan` (varredura do vídeo inteiro), em segundos.
# Faixa: 30–7200. Padrão: 900. A varredura baixa esse tanto de mídia de trabalho.
# GB_SCAN_MAX_SECONDS=900


# ── Chaves de API dos provedores ─────────────────────────────────────
# YouTube, Instagram, TikTok, Wikimedia Commons e NASA NÃO precisam de chave.
# Bancos de imagem precisam: sem a chave, a busca daquele provedor fica desligada.
# As chaves são ocultadas nos logs e nas mensagens de erro.

# Pexels — chave gratuita em https://www.pexels.com/api/
PEXELS_API_KEY=

# Pixabay — chave gratuita em https://pixabay.com/api/docs/
PIXABAY_API_KEY=

# Chave da API de dados do YouTube. Opcional: a busca no YouTube funciona sem ela.
YOUTUBE_API_KEY=


# ── Regras e brief ───────────────────────────────────────────────────
# As regras editoriais valem em camadas (num valor único a última vence; listas se somam):
#   ~/.getbrolls/RULES.md  →  GB_RULES_FILE  →  <projeto>/RULES.md
# Sem RULES.md no projeto, a base é o modelo da skill (docs/RULES.md).

# Arquivo de regras extra, aplicado a todo projeto desta máquina. Precisa existir.
# Exemplo: GB_RULES_FILE=/caminho/para/RULES.md
GB_RULES_FILE=

# Caminho alternativo do BRIEF.md. Padrão: <projeto>/BRIEF.md.
# Um caminho fora da pasta do projeto vale para todo projeto desta máquina.
# GB_BRIEF_FILE=


# ── Pasta pessoal e biblioteca ───────────────────────────────────────
# Pasta pessoal: seu RULES.md global e a biblioteca entre projetos do
# "que já funcionou". Padrão: ~/.getbrolls
# GB_HOME=

# Use `off` para desligar a biblioteca global: `learn` e `library`
# não leem nem gravam nada.
# GB_LIBRARY=off

# Lista de ids de plugin separados por vírgula: escolhe, entre os plugins já
# habilitados com pin de hash válido, os que esta sessão carrega (nunca carrega
# plugin não habilitado nem com conteúdo mudado). `off` desliga todos os plugins.
# GB_PLUGINS=


# ── Caminhos das ferramentas ─────────────────────────────────────────
# Deixe vazio, a não ser que o `doctor` não encontre uma ferramenta. Um caminho
# explícito sempre vence a descoberta automática. Cada caminho precisa existir.

# Executável do yt-dlp. Padrão: a .venv da skill, depois o seu PATH.
# GB_YTDLP_PATH=

# Pasta .venv usada para localizar o yt-dlp. Padrão: .venv na raiz da skill.
# GB_VENV_PATH=

# Pasta com a .venv/ (yt-dlp) e a .tools/ (Playwright) que o getbrolls usa.
# Padrão: $GB_HOME/runtime/<versão das dependências>/; o checkout mantém a própria .venv e .tools.
# GB_RUNTIME_DIR=

# Executável do FFmpeg. Padrão: `ffmpeg` no seu PATH.
# Exemplo: GB_FFMPEG_PATH=/opt/homebrew/bin/ffmpeg
# GB_FFMPEG_PATH=

# Executável do ffprobe. Padrão: `ffprobe` no seu PATH.
# GB_FFPROBE_PATH=


# ── Fonte do contact sheet ───────────────────────────────────────────
# Fonte TrueType usada para rotular o contact sheet. Padrão: a primeira entre
# DejaVu, Liberation ou Arial encontrada no sistema. Precisa existir quando definida.
# GB_FONT_FILE=


# ── Ritmo da fila social ─────────────────────────────────────────────
# `getbrolls queue` espaça os downloads de Instagram, TikTok e YouTube para a
# fonte não bloquear você. Padrões:
#   pausa entre itens   Instagram 45–120 s · TikTok e YouTube 15–40 s
#   tetos               20 itens por hora · 60 itens por dia
#
# Estas variáveis aplicam o MESMO valor a todo provedor e vencem o
# RULES.md. Para ajustar um provedor só, use o bloco opcional "pacing"
# do RULES.md.

# Pausa aleatória entre itens, em segundos. Faixa: 0–86400 cada.
# GB_PACE_MIN_S=
# GB_PACE_MAX_S=

# Tetos. Faixa: 1–10000 por hora, 1–100000 por dia.
# GB_MAX_PER_HOUR=
# GB_MAX_PER_DAY=

# Pausas do yt-dlp entre os pedidos dele: "requests,min,max" em segundos
# inteiros, com min <= max. Padrão: 1,3,8
# GB_YTDLP_SLEEP=1,3,8


# ── Cache e entrega ──────────────────────────────────────────────────
# Pasta do cache local (respostas de provedores e sondagens do FFmpeg).
# Padrão: ~/.cache/getbrolls
# O nome antigo GETBROLLS_CACHE_DIR continua valendo quando exportado no shell;
# com os dois definidos, vale GB_CACHE_DIR.
# GB_CACHE_DIR=

# `deliver` normalmente cria hardlinks dos cortes em entrega/ (sem ocupar mais disco).
# Use 1 para receber cópias independentes, que você pode editar ali mesmo.
# GB_DELIVERY_COPY=1


# ── Logs ─────────────────────────────────────────────────────────────
# <projeto>/brolls/getbrolls.log: uma linha chave=valor por evento, separado
# do diagnostics.jsonl. Comando que muda a instalação fora de um projeto
# (plugins, client, template, profile trust/untrust, setup) grava as mesmas
# linhas em $GB_HOME/logs/getbrolls.log. Cada arquivo gira a cada ~1 MB,
# mantendo 3 cópias antigas. Chaves e a sua pasta pessoal são ocultadas
# antes de qualquer gravação, igual ao resto deste arquivo.

# Nível dos dois arquivos. DEBUG, INFO, WARNING, ERROR ou off para desligar
# os dois por completo. Padrão: INFO.
# GB_LOG_LEVEL=INFO

# Use 1 para também imprimir as linhas do log em stderr (depuração
# interativa). O envelope JSON de erro continua sempre a última linha de
# stderr. Padrão: desligado.
# GB_LOG_STDERR=

# Use json para forçar a saída de máquina. Hoje toda saída já é JSON; outro
# valor não muda nada.
# GB_OUTPUT=

1. Atualize o getbrolls seguindo o README do repositório.
2. Rode o setup de novo. Ele instala só o que mudou e não refaz o que já está pronto.

Vindo da 2.5? Veja o que muda.