CLI/rename

renamed rename

Renomeação de arquivos com IA. Analisa o conteúdo do documento para gerar nomes de arquivo descritivos e pesquisáveis automaticamente.

renamed rename <path> [options]

O comando rename escaneia arquivos e usa IA para entender seu conteúdo. Ele extrai datas, nomes de empresas, valores, tipos de documentos e outros metadados para criar nomes de arquivo limpos e consistentes.

Por padrão, ele é executado no modo de teste — mostrando o que mudaria sem modificar os arquivos. Adicione --apply para executar as renomeações.

Exemplos

Visualizar alterações (seguro, sem modificações):

$ renamed rename ./documents/

Aplicar as renomeações:

$ renamed rename ./documents/ --apply

Renomear e mover para pastas organizadas:

$ renamed rename ./incoming/ --apply --output-dir ~/Organized

Processar apenas PDFs, recursivamente:

$ renamed rename ./docs/ --pattern "*.pdf" -r --apply

Opções

-a, --apply

Executar as renomeações. Sem esta flag, executa no modo de visualização.

-o, --output-dir <path>

Mover arquivos renomeados para um diretório diferente. A IA organizará em subpastas.

-s, --strategy <strategy>

Estratégia de organização de pastas. Veja estratégias abaixo.

-t, --template <template>

Formato do modelo de nome de arquivo. Veja modelos abaixo.

-p, --prompt <text>

Instruções personalizadas de IA para gerar nomes de arquivo.

-l, --language <lang>

Idioma preferido para nomes de arquivo gerados (por exemplo, en, de, fr).

--overwrite

Sobrescrever arquivos existentes com o mesmo nome.

-r, --recursive

Processar arquivos em subdiretórios.

--concurrency <n>

Processar n arquivos em paralelo. Padrão: 4.

-v, --verbose

Mostrar saída de processamento detalhada.

Estratégias de Organização

by_date Organizar por ano/mês (por exemplo, 2026/01/file.pdf)

by_issuer Organizar por nome da empresa/remetente

by_type Organizar por tipo de documento (invoices/, receipts/, contracts/)

by_date_issuer Combinar data e emissor (por exemplo, 2026/AcmeCorp/file.pdf)

by_date_type Combinar data e tipo

by_issuer_type Combinar emissor e tipo

by_all Hierarquia completa (date/issuer/type)

root Sem subpastas, manter arquivos no diretório de saída

follow_custom_prompt Deixar a IA decidir com base no seu prompt personalizado

Modelos de Nome de Arquivo

standard Formato equilibrado: 2026-01-15_AcmeCorp_Invoice_INV-001.pdf

date_first Focado em data: 2026-01-15_Invoice_AcmeCorp.pdf

company_first Focado em empresa: AcmeCorp_2026-01-15_Invoice.pdf

minimal Formato curto: 2026-01-15_Invoice.pdf

detailed Metadados completos: 2026-01-15_AcmeCorp_Invoice_INV-001_$2450.pdf

department_focus Nomenclatura centrada em departamento

Saída

Analisando 47 arquivos...

 IMG_4521.pdf
 2026-01-15_AcmeCorp_Invoice_INV-8847.pdf

 scan0042.pdf
 2026-01-14_Receipt_Starbucks_$12.50.pdf

 document.pdf
 2026-01-13_Contract_NDA_TechCorp.pdf

Pronto! 47 arquivos renomeados em 2,3s

Veja Também