renamed watch
フォルダの新規ファイルを監視して自動処理します。ヘルスチェック、リトライ処理、グレースフルシャットダウンを備えた本番環境対応。
インストール不要で即座にお試しください:
$ npx @renamed-to/cli watch ~/Downloads --output-dir ~/Organizedrenamed watch <directory> [options]watchコマンドはディレクトリの新規ファイルを監視する長寿命プロセスとして実行されます。ファイルが現れるとキューに入れられ、AIリネームで処理され、オプションで整理された出力フォルダに移動されます。
並行ワーカー、指数バックオフによるリトライ、Unixソケットヘルスモニタリングを備えた本番環境向けに設計されています。
使用例
ダウンロードを監視して~/Organizedに整理:
$ renamed watch ~/Downloads --output-dir ~/Organized --applyPDFのみを4つの並行ワーカーで監視:
$ renamed watch ~/Documents -p "*.pdf" --concurrency 4本番モードでJSONログを出力:
$ renamed watch /data/incoming --apply --log-format jsonオプション
-o, --output-dir <path>処理済みファイルをここに移動します。AIがサブフォルダに整理します。
-p, --patterns <globs>パターンにマッチするファイルのみ監視(例:"*.pdf *.jpg *.png")。デフォルト: *.pdf *.jpg *.png
-f, --failed-dir <path>処理に失敗したファイルをここに移動します(そのままにしておく代わりに)。
-n, --dry-runプレビューモード。ファイルを処理せずに何が起こるか確認します。
--concurrency <n>並列ワーカー数(1-10)。デフォルト: 2。
-c, --config <path>YAML設定ファイルのパス。
--log-format <type>出力形式: text、json。ログ集約にはjsonを使用。
本番環境機能
並行ワーカー — 複数のファイルを並列処理します。ハードウェアに応じて1-10で設定可能。
バックオフ付きリトライ — 失敗したファイルは指数遅延(5秒→10秒→20秒)で自動リトライされます。
グレースフルシャットダウン — SIGTERM/SIGINTでキューをドレインします。処理途中のファイルが残りません。
ヘルスモニタリング — モニタリングツールと統合するためのUnixソケットエンドポイント。
ヘルスチェック
ヘルスエンドポイントにクエリ:
$ curl --unix-socket /tmp/renamed.sock http://localhost/health
{
"status": "healthy",
"uptime": 847293,
"queue": {"pending": 3, "processing": 2}
}設定ファイル
複雑なセットアップにはYAML設定を使用:
watch:
patterns: ["*.pdf", "*.jpg", "*.png"]
rateLimit:
concurrency: 4
retryAttempts: 3
health:
enabled: true
socketPath: /tmp/renamed.sock