Cursor の容量

Mac で Cursor が使っている容量の行き先

Cursor のデータは ~/Library/Application Support/Cursor にあり、プロジェクトのフォルダは原因ではありません。大部分は workspaceStorage フォルダ、チャット履歴を保存する状態データベース、キャッシュフォルダです。Cursor を終了していれば、キャッシュは気軽に消してかまいません。

Cursor のフォルダの中身

User/workspaceStorage には、Cursor で開いたことのあるプロジェクトごとにフォルダが作られます。フォルダ名はハッシュで、中の workspace.json がプロジェクトのパスを指しています。プロジェクトを削除したり移動したりしても、このフォルダは残ったままです。

User/globalStorage/state.vscdb はチャット履歴を保存する SQLite データベースです。ある開発者の Mac では 2.64 GB あり、中身はすべてテキストで画像は入っていませんでした。チャットの画像は workspaceStorage/<hash>/images に普通のファイルとして別に保存されていて、その Mac では 284 ファイル、56 MB でした。

Cache、CachedData、Code Cache、GPUCache は Cursor の起動時に作り直されます。フォーラムでは、大きなモノレポで workspaceStorage 内の .pack ファイルが 1 GB を超えたという報告もあり、これはそのワークスペースのローカル履歴です。

キャッシュを手作業で消す

Cursor のデータのうち、自分のものを何も失わずに消せるのはこのキャッシュフォルダだけです。

  1. Cursor を終了します。
  2. Finder で ~/Library/Application Support/Cursor を開き、サイズ順に並べます。
  3. Cache、CachedData、Code Cache、GPUCache の各フォルダを削除します。
  4. Cursor をもう一度開き、キャッシュを作り直させます。

Mint でできること

Mint は「ディスク」タブに Cursor を名前付きで表示し、各部分のサイズを測ります。Cursor を閉じているときは、キャッシュフォルダを削除の対象として表示します。Cursor が開いている間は使われていないキャッシュのエントリだけを対象にし、まだ消せないキャッシュは「キープ」に入れて、先に Cursor を閉じるよう表示します。

Mint が確認するのは Cursor アプリ本体が動いているかどうかなので、バックグラウンドに cursor-agent のプロセスが残っていても、終了後にキャッシュがロックされたままにはなりません。状態データベース、チャットの画像、workspaceStorage のフォルダはサイズを測るだけで手を付けません。もう存在しないプロジェクトのフォルダも同じで、そのプロジェクトのチャットが残っている可能性があるからです。

削除する前に確認したいこと

Cursor のフォルダを丸ごと消すのはやめましょう。設定、キーバインド、拡張機能の状態、すべてのチャットが一緒に消えます。

Cursor の起動中は state.vscdb に触れず、自分で小さくしようともしないでください。安全に整理できるのは Cursor だけです。まだ存在するプロジェクトの workspaceStorage フォルダには、そのプロジェクトのエディタの状態が入っています。削除したプロジェクトの残りのフォルダにも以前のチャットや画像が残っていることがあるので、消す前に中を確認してください。

よくある質問

Cursor がこれほど容量を使うのはなぜですか?

主な理由は、workspaceStorage が開いたプロジェクトごとにフォルダを増やし続けること、状態データベースが大きくなり続けること、キャッシュがたまることです。プロジェクトのフォルダは含まれません。

Cursor のキャッシュを消すとチャットも消えますか?

消えません。チャットは状態データベースに、チャットの画像は workspaceStorage にあります。キャッシュフォルダはそれとは別で、Cursor が作り直します。

Cursor の workspaceStorage を削除しても大丈夫ですか?

丸ごと消すのは避けてください。プロジェクトがもうないフォルダは、そのプロジェクトのチャットが不要なら消せますが、使っているプロジェクトのフォルダにはエディタの状態が入っています。

Cursor を閉じたのに、クリーナーが起動中だと表示するのはなぜですか?

たいていは cursor-agent のプロセスがまだ動いています。Mint は Cursor アプリ本体だけを見ますが、ほかのツールはこうしたプロセスも起動中として数えることがあります。

Cursor が Mac に残しているものを確認しましょう

スキャンしてから「ディスク」タブで Cursor を探してください。Cursor を閉じると、キャッシュ全体が一覧に表示されます。

AI エージェントの容量をスキャン