renamed watch

Monitore pastas para novos arquivos e processe-os automaticamente. Pronto para produção com verificações de saúde, tratamento de repetição e desligamento elegante.

Experimente instantaneamente — sem necessidade de instalação:

$ npx @renamed-to/cli watch ~/Downloads --output-dir ~/Organized

renamed watch <directory> [options]

O comando watch é executado como um processo de longa duração que monitora diretórios para novos arquivos. Quando os arquivos aparecem, eles são enfileirados e processados com renomeação por IA, e então opcionalmente movidos para pastas de saída organizadas.

Projetado para ambientes de produção com workers simultâneos, backoff exponencial de repetição e monitoramento de saúde via socket Unix.

Exemplos

Monitorar Downloads e organizar para ~/Organized:

$ renamed watch ~/Downloads --output-dir ~/Organized --apply

Monitorar apenas PDFs com 4 workers simultâneos:

$ renamed watch ~/Documents -p "*.pdf" --concurrency 4

Modo de produção com logs JSON:

$ renamed watch /data/incoming --apply --log-format json

Opções

-o, --output-dir <path>

Mover arquivos processados para aqui. A IA organiza em subpastas.

-p, --patterns <globs>

Monitorar apenas arquivos correspondentes aos padrões (por exemplo, "*.pdf *.jpg *.png"). Padrão: *.pdf *.jpg *.png

-f, --failed-dir <path>

Mover arquivos que falham no processamento para cá em vez de deixá-los no lugar.

-n, --dry-run

Modo de visualização. Veja o que aconteceria sem processar arquivos.

--concurrency <n>

Workers paralelos (1-10). Padrão: 2.

-c, --config <path>

Caminho para arquivo de configuração YAML.

--log-format <type>

Formato de saída: text, json. Use json para agregação de logs.

Recursos de Produção

Workers simultâneos — Processe vários arquivos em paralelo. Configurável de 1 a 10 com base no seu hardware.

Repetição com backoff — Arquivos com falha tentam novamente automaticamente com atrasos exponenciais (5s → 10s → 20s).

Desligamento elegante — SIGTERM/SIGINT drena a fila. Nenhum arquivo deixado pela metade do processamento.

Monitoramento de saúde — Endpoint de socket Unix para integração com ferramentas de monitoramento.

Verificação de Saúde

Consultar o endpoint de saúde:

$ curl --unix-socket /tmp/renamed.sock http://localhost/health

{
 "status": "healthy",
 "uptime": 847293,
 "queue": {"pending": 3, "processing": 2}
}

Arquivo de Configuração

Para configurações complexas, use configuração YAML:

~/.config/renamed/config.yaml

watch:
 patterns: ["*.pdf", "*.jpg", "*.png"]

rateLimit:
 concurrency: 4
 retryAttempts: 3

health:
 enabled: true
 socketPath: /tmp/renamed.sock

Veja Também

service — executar como serviço systemd rename — renomeação em lote única