af-clean
ターミナルから ホームディレクトリのディスクを空けます。Console の容量不足の通知にある 再生成できるものを掃除… と同じ一覧を使います。 ワークスペースの Agent に消せるものを尋ね、その分だけを消します。動いているワークスペースの中でだけ使えます。 Console 側の説明は マシンと使用状況を見る にあります。
af-clean [--dry-run] [--json]af-clean --apply [--json]af-clean --help| オプション | 動作 |
|---|---|
なし、--dry-run |
消すものの一覧を出します。何も削除しません |
--apply |
新しく一覧を作り、その項目を削除します |
--json |
テキストの代わりに JSON を 1 つ出します |
--apply と --dry-run は同時に指定できません。
| 種類 | 消えるもの | 対象になる条件 |
|---|---|---|
worktree |
作業コピーの node_modules、.next、target、.gradle(作業コピー自体は残る) |
30 日間誰も触っておらず、未コミット・未追跡の変更がなく、使っているセッションやプロセスもない |
cache |
パッケージマネージャーのキャッシュ(go-build、npm、uv、pip、Maven、どのプロジェクトも固定していない Gradle のバージョン) | 中身があり、ビルドやインストールが使っておらず、Agent が対象として出している |
ここから消すのは、この 2 種類の項目だけです。ごみ箱、セッションのアーカイブ、使われなくなったファイル、~/.af-work、ホームディレクトリ全体の内訳は
Console にだけ出ていて、それぞれ確認を挟みます。
削除は元に戻せず、ごみ箱にも入りません。消したものを次に必要とするビルドやインストールは、一度だけ遅くなります。
--apply が一覧の外に出ない仕組み
Section titled “--apply が一覧の外に出ない仕組み”- 自分で作った新しい一覧の項目を、1 件ずつリクエストして消します。Console が頼まないことは頼みません。以前の
--dry-runの結果は使い回さず、実行のたびに読み直すので、前のドライランと内容が違うことがあります。 - 作業コピーを掃除する直前に、その作業コピーの一覧をもう一度読みます。フォルダが一覧のときと違えば、その項目は
skipped(「一覧のあとで変わった」)にして、何も消しません。新しい一覧はaf-cleanをもう一度実行して確認します。 - Agent の削除は作業コピーの名前しか渡しません。その最後の確認のあと、削除までの間に
.nextのようなフォルダができると、Console と同じく一緒に消えます。 - Agent が拒んだもの(動いているセッション、使用中のキャッシュ)は失敗ではなく
skippedです。確認をやり直せなかった場合(Agent に届かない、HTTP エラー)はfailedで、その項目では何も削除しません。
worktree my-app-feature-x 1.2 GiB node_modules 1.1 GiB .next 100.0 MiBcache npm 800.0 MiBdry run: 2.0 GiB can be freed; nothing was deleted. Run af-clean --apply to list again and remove these items.サイズの後ろの + は下限値です(計測が上限に達して止まりました)。--apply では各行の末尾に
removed (<サイズ>)、skipped、failed が付き、最後に freed <サイズ>, <n> skipped, <n> failed が出ます。
--json は mode、items(id、kind、name、bytes、dirs、--apply では outcome、freed、detail)、
total_bytes、--apply では freed_bytes、skipped、failed を出します。2 つの取得元の一方が読めなかったときは partial が true です。
| 値 | 意味 |
|---|---|
| 0 | 完了(skipped は失敗に数えません) |
| 1 | 項目が失敗した、または Agent に尋ねられない・使える答えがなかった |
| 2 | 使いかたの誤り。使いかたも表示します |
エラーは標準エラー出力に af-clean: <メッセージ> で出ます。cannot reach the Agent on this workspace は、動いているワークスペースの中で実行していないことを意味します。