copper-golem

使い方はシンプルです。整理したいフォルダ（たとえば「受信箱」）を1つ決め、その中に 「請求書」「写真」「資料」のような入れ先フォルダを作っておきます。 あとは受信箱にファイルを置くだけ。copper-golem が中身を読み取り、いちばん合う入れ先へ移してくれます。

ポイントは、ファイル名ではなく中身で判断すること。 「IMG_2084.png」のような名前でも、中を見て「写真」と分かれば写真フォルダへ。 どの入れ先にも当てはまらないファイルは動かさず、なぜ分けられなかったかを一覧に書き出して教えてくれます。

1. 準備するもの

   Mac、そして AI の Claude Code（claude コマンド）が使える状態。 通知をしっかり受け取りたい場合は、あとで terminal-notifier という小さな道具も入れます。

2. ツールを取ってくる

   「ターミナル」アプリを開き、次を貼り付けて実行します。

   git clone https://github.com/knktkc/copper-golem.git cd copper-golem

3. 設定ファイルを置く

   監視するフォルダなどの設定を、自分用にコピーします。

   mkdir -p ~/.config/copper-golem cp config.example.toml ~/.config/copper-golem/config.toml

   テキストエディタで ~/.config/copper-golem/config.toml を開き、 watch_roots（監視するフォルダ）を整理したい場所に変えます。

4. 入れ先フォルダを作る

   監視フォルダの中に、振り分け先を自分で作ります（最低1つ）。例：

   mkdir -p ~/Downloads/inbox/{請求書,写真,資料}
   入れ先フォルダが1つも無いと、何も起きません。先にフォルダを作ってください。

5. まず「お試し」で確認する

   いきなり動かさず、移動せずに判定結果だけを表示して確かめます（安全）。

   python3 golem.py --dry-run [dry-run] 請求書_2026.pdf → 請求書/ [keep] メモ.txt （どこにも当てはまらず、そのまま）

6. 自動で動かす

   結果に納得できたら、置いた瞬間に自動で整理するよう登録します。

   ./install.sh

   これで完了。以降は、監視フォルダにファイルを入れるたびに自動で振り分けられます。

手で書いてもいいですが、フォルダにすでに入っているファイルから自動で作ることもできます。

作られた説明はあとから手で直せます。とくに「入れないもの」に 「スクリーンショットは入れない」などの条件を足すと、思いどおりに分かれやすくなります。

これを見れば、「なぜ片付かないのか」がひと目で分かります。新しい入れ先フォルダを作ったり、 .golem.md の「入れないもの」を調整するヒントになります。 ファイルがすべて片付けば、このレポートは自動で消えます。

しばらく休ませたいだけなら、設定ファイルの dry_run を true にして保存します。 その間はファイルを移動せず、判定だけ行う「お試しモード」になります（保存するだけで反映され、入れ直しは不要）。