renamed watch

Monitori le cartelle per nuovi file ed elaborali automaticamente. Pronto per la produzione con controlli di salute, gestione dei tentativi e arresto graduale.

Provi istantaneamente — nessuna installazione necessaria:

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

renamed watch <directory> [options]

Il comando watch viene eseguito come un processo di lunga durata che monitora le directory per nuovi file. Quando appaiono i file, vengono messi in coda ed elaborati con rinomina AI, quindi facoltativamente spostati in cartelle di output organizzate.

Progettato per ambienti di produzione con worker concorrenti, backoff esponenziale per i tentativi e monitoraggio dello stato tramite socket Unix.

Esempi

Monitora Downloads e organizza in ~/Organized:

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

Monitora solo PDF con 4 worker concorrenti:

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

Modalità produzione con log JSON:

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

Opzioni

-o, --output-dir <path>

Sposta qui i file elaborati. AI organizza in sottocartelle.

-p, --patterns <globs>

Monitora solo i file che corrispondono ai pattern (es. "*.pdf *.jpg *.png"). Predefinito: *.pdf *.jpg *.png

-f, --failed-dir <path>

Sposta qui i file che falliscono l'elaborazione invece di lasciarli sul posto.

-n, --dry-run

Modalità anteprima. Vedi cosa succederebbe senza elaborare i file.

--concurrency <n>

Worker paralleli (1-10). Predefinito: 2.

-c, --config <path>

Percorso al file di configurazione YAML.

--log-format <type>

Formato di output: text, json. Utilizzi json per l'aggregazione dei log.

Funzionalità per la Produzione

Worker concorrenti — Elabora più file in parallelo. Configurabile da 1-10 in base al Suo hardware.

Tentativi con backoff — I file falliti vengono ritentati automaticamente con ritardi esponenziali (5s → 10s → 20s).

Arresto graduale — SIGTERM/SIGINT svuotano la coda. Nessun file lasciato a metà elaborazione.

Monitoraggio dello stato — Endpoint socket Unix per l'integrazione con strumenti di monitoraggio.

Controllo dello Stato

Interroghi l'endpoint di stato:

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

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

File di Configurazione

Per configurazioni complesse, utilizzi la configurazione YAML:

~/.config/renamed/config.yaml

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

rateLimit:
 concurrency: 4
 retryAttempts: 3

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

Vedi Anche

service — esegui come servizio systemd rename — rinomina batch una tantum