ドキュメント
CLI/watch

renamed watch

フォルダの新規ファイルを監視して自動処理します。ヘルスチェック、リトライ処理、グレースフルシャットダウンを備えた本番環境対応。

インストール不要で即座にお試しください:

$ npx @renamed-to/cli watch ~/Downloads --output-dir ~/Organized
renamed watch <directory> [options]

watchコマンドはディレクトリの新規ファイルを監視する長寿命プロセスとして実行されます。ファイルが現れるとキューに入れられ、AIリネームで処理され、オプションで整理された出力フォルダに移動されます。

並行ワーカー、指数バックオフによるリトライ、Unixソケットヘルスモニタリングを備えた本番環境向けに設計されています。

使用例

ダウンロードを監視して~/Organizedに整理:

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

PDFのみを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設定を使用:

~/.config/renamed/config.yaml
watch:
 patterns: ["*.pdf", "*.jpg", "*.png"]

rateLimit:
 concurrency: 4
 retryAttempts: 3

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

関連項目