renamed watch

Monitoree carpetas para archivos nuevos y procéselos automáticamente. Listo para producción con verificaciones de salud, manejo de reintentos y apagado elegante.

Pruébelo instantáneamente — no requiere instalación:

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

renamed watch <directory> [options]

El comando watch se ejecuta como un proceso de larga duración que monitorea directorios en busca de archivos nuevos. Cuando aparecen archivos, se ponen en cola y se procesan con renombrado con IA, luego opcionalmente se mueven a carpetas de salida organizadas.

Diseñado para entornos de producción con trabajadores concurrentes, retroceso exponencial de reintentos y monitoreo de salud mediante socket Unix.

Ejemplos

Vigilar Downloads y organizar en ~/Organized:

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

Vigilar solo PDFs con 4 trabajadores concurrentes:

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

Modo de producción con registros JSON:

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

Opciones

-o, --output-dir <path>

Mueva archivos procesados aquí. La IA organiza en subcarpetas.

-p, --patterns <globs>

Solo vigilar archivos que coincidan con patrones (ej., "*.pdf *.jpg *.png"). Predeterminado: *.pdf *.jpg *.png

-f, --failed-dir <path>

Mueva archivos que fallen en el procesamiento aquí en lugar de dejarlos en su lugar.

-n, --dry-run

Modo de vista previa. Vea qué sucedería sin procesar archivos.

--concurrency <n>

Trabajadores paralelos (1-10). Predeterminado: 2.

-c, --config <path>

Ruta al archivo de configuración YAML.

--log-format <type>

Formato de salida: text, json. Use json para agregación de registros.

Características de Producción

Trabajadores concurrentes — Procese múltiples archivos en paralelo. Configurable de 1-10 según su hardware.

Reintento con retroceso — Los archivos fallidos se reintentan automáticamente con retrasos exponenciales (5s → 10s → 20s).

Apagado elegante — SIGTERM/SIGINT vacía la cola. No quedan archivos procesados a medias.

Monitoreo de salud — Punto de conexión de socket Unix para integración con herramientas de monitoreo.

Verificación de Salud

Consulte el punto de conexión de salud:

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

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

Archivo de Configuración

Para configuraciones complejas, use configuración YAML:

~/.config/renamed/config.yaml

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

rateLimit:
 concurrency: 4
 retryAttempts: 3

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

Ver También

service — ejecutar como servicio systemd rename — renombrado único por lotes