KURA

A kura (蔵) is the thick-walled storehouse at the back of a Japanese property — where a household keeps what it owns but does not use. Everything ends up in one, and nobody knows what is in theirs. The app does three things about that: browse, measure, and clean.

蔵（くら）は、日本の家の奥にある分厚い壁の倉庫で、持っているけれど使っていないものをしまう場所です。何でも最後は蔵に入り、誰も自分の蔵に何があるか知りません。このアプリはそれに対して3つのことをします。見る、測る、片付ける。

Disk-space tools tell you what is big. Finder tells you what is there. Neither answers the question people actually have, which is what is growing. Kura remembers every measurement it takes, so the second time you look at a folder it can show a sparkline and a delta since last time — and a breadcrumb running the whole way back to / where each crumb it has measured before carries what it measured.

ディスク容量ツールは何が大きいかを教えてくれます。Finderは何があるかを教えてくれます。けれどもどちらも、本当に知りたい「何が増えているか」には答えません。Kuraは測定結果をすべて記憶するため、2回目にフォルダを開いたときには、前回からの増減と推移の小さなグラフを表示できます。ルート（/）までのパンくずリストにも、測定済みの階層にはその結果が表示されます。

Most of the engineering went into behaving well at sizes that break file managers. A folder of two hundred thousand files takes seconds to stat, and returning it in one call meant a frozen window followed by one enormous JSON payload for the webview to parse on its main thread. Rust now streams the listing in slices of 500 and the view fills as it reads: the first slice renders immediately, the rest are pooled and flushed on a timer, because every flush re-sorts the whole list and sorting two hundred thousand entries sixty times a second is its own freeze. Navigating away cancels the read rather than finishing a job nobody is waiting for.

開発の大半は、一般的なファイルマネージャーが破綻する規模でもきちんと動くことに費やしました。20万ファイルのフォルダは情報の取得だけで数秒かかり、それを1回で返すと、ウィンドウが固まった後に巨大なJSONが届き、webviewがメインスレッドでそれを解析することになります。現在はRustが500件ずつ分割して送り、読み込みながら表示が埋まっていきます。最初の500件はすぐに描画し、残りはまとめてタイマーで反映します。反映のたびに一覧全体を並べ替えるため、20万件を毎秒60回並べ替えると、それ自体が固まりの原因になるからです。別の場所へ移動すれば読み込みは中止し、誰も待っていない処理を続けることはしません。

Streaming two hundred thousand files20万ファイルを分割して送る

Returning a large folder in one call meant seconds of frozen window followed by one enormous JSON payload parsed on the webview's main thread. Rust sends slices of 500 instead: the first renders immediately, the rest are pooled and flushed on a timer, because each flush re-sorts the whole list and sorting two hundred thousand entries sixty times a second is its own freeze.

大きなフォルダを1回で返すと、数秒間ウィンドウが固まった後、巨大なJSONをwebviewのメインスレッドで解析することになっていました。現在はRustが500件ずつ送ります。最初の分はすぐ描画し、残りはまとめてタイマーで反映します。反映のたびに一覧全体を並べ替えるため、20万件を毎秒60回並べ替えると、それ自体で固まってしまうからです。

Selection by arithmetic, not measurement測定ではなく計算による選択

Tiles are a uniform size, so which are visible is arithmetic and the only measured value is row height for wrapped captions. The rubber band works the same way — O(what you selected) rather than O(what is in the folder), and the only way a band dragged past the bottom of the screen can take items the window has left unmounted.

タイルは一定サイズなので、どれが見えているかは計算で決まり、測定するのは折り返したキャプションの行の高さだけです。範囲選択も同じ仕組みで、処理量はフォルダの規模ではなく選択した数に比例します。画面下まではみ出してドラッグしても、描画されていない項目まで選択できる唯一の方法でもあります。

Why drag and drop is hand-rolledドラッグ＆ドロップを自作した理由

macOS routes every drag over a webview through the native view first, and Tauri installs a handler there so files from Finder arrive with real filesystem paths — something the DOM will not give us. That handler consumes the drag before WebKit sees it, so dragover and drop never fire on anything in the page. Doing it from pointer events keeps both halves working, and lets the label under the cursor say whether the drop will copy or move.

macOSはwebview上のドラッグをまずネイティブのビューに渡し、TauriはFinderからのファイルを実際のパスで受け取るためにそこへハンドラーを設置します。DOMからは得られない情報です。そのハンドラーがWebKitより先にドラッグを受け取るため、ページ内ではdragoverもdropも発生しません。ポインターイベントで実装すれば両方が動き、カーソルの下のラベルでコピーか移動かも示せます。

Undo that does not lie嘘をつかない取り消し

⌘Z undoes a rename or a move, but not a trash. macOS has no public Put Back API, and an undo that silently did something other than what it said would be worse than not offering one.

⌘Zで名前の変更や移動は取り消せますが、ゴミ箱への移動は取り消せません。macOSには「戻す」の公開APIがなく、表示とは違うことを黙って行う取り消しなら、ない方がましだからです。

Tauri 2 with a Rust core and a React 19 / Vite / Tailwind 4 front end. Directory walking is jwalk running parallel on a background thread with a cancel button and progress events, because a home folder is routinely several hundred thousand entries. The grid and list virtualise: tiles are a uniform size so visibility is arithmetic rather than measurement, spacers stand in for what is not drawn so the scrollbar still describes the whole folder, and the entrance animation is dropped past 400 items — a stagger across forty tiles is a nice touch, across four thousand it is four thousand simultaneous transforms. Rubber-band selection works by index arithmetic too, which is both O(what you selected) rather than O(what is in the folder) and the only way a band dragged past the bottom of the screen can take items the window has left unmounted. Dragging is done from pointer events rather than HTML5 drag and drop, which cannot work in this window at all: macOS routes every drag over a webview through the native view first, and Tauri installs a handler there so Finder's files arrive with real filesystem paths — that handler consumes the drag before WebKit sees it, so dragover and drop never fire in the page. Kura registers as a Viewer for folders and volumes at rank Alternate, which is the honest one: Finder owns folders, Kura offers to.

Tauri 2とRustのコア、React 19・Vite・Tailwind 4のフロントエンド。ホームフォルダは数十万項目になることが珍しくないため、ディレクトリの走査はjwalkでバックグラウンドスレッドで並列に行い、キャンセルボタンと進捗イベントを備えています。グリッドとリストは仮想化しています。タイルは一定サイズなので、表示範囲は測定ではなく計算で決まり、描画しない部分はスペーサーで埋めるため、スクロールバーはフォルダ全体を正しく表します。登場アニメーションは400項目を超えると省きます。40個のタイルに時間差をつけるのは良い演出ですが、4,000個では4,000個の同時変形になるからです。範囲選択もインデックス計算で行うため、処理量はフォルダの規模ではなく選択した数に比例し、画面下まではみ出してドラッグしても、描画されていない項目まで選択できます。ドラッグはHTML5のドラッグ＆ドロップではなくポインターイベントで実装しています。このウィンドウではHTML5の方式がそもそも動かないからです。macOSはwebview上のドラッグをまずネイティブのビューに渡し、TauriはFinderのファイルを実際のパスで受け取るためにそこへハンドラーを設置します。そのハンドラーがWebKitより先にドラッグを受け取ってしまうため、ページ内ではdragoverもdropも発生しません。Kuraはフォルダとボリュームの「代替」ビューアとして登録しています。フォルダの持ち主はFinderで、Kuraは選択肢を提供する、という正直な位置づけです。

Kura is a working Finder replacement — five layouts, streaming listings, per-file copy jobs, real Finder tags, treemap sizing, duplicate detection and Trash-only cleanup — running as a local build. It is not signed or released; notarisation and a DMG are what stand between it and being installable by anyone else.

Kuraは実際に使えるFinderの代替で、5つの表示、分割読み込み、ファイル単位のコピージョブ、本物のFinderタグ、ツリーマップによる容量表示、重複検出、ゴミ箱への移動だけのクリーンアップを備え、ローカル版として動いています。署名とリリースはまだで、公証とDMGを用意すれば誰でもインストールできるようになります。