Katazuke

An Obsidian plugin for confronting the over-connected notes your past self left behind. Katazuke (片付け) means "tidying up."

日本語版は README.ja.md にあります。

Why

A note that has accumulated too many links can be an unhealthy sign — it has quietly become a catch-all instead of a focused idea. But that sprawl is hard to spot in the graph view.

Katazuke measures it directly. The signal is degree (link count): the more links a note has, and the longer it has been left untouched, the more it is worth revisiting. Intentional hubs (maps of content) are excluded by tag, so only the notes that grew dense without you deciding they should rise to the top.

This is closer to a ritual than a linter — you occasionally sit with one note, confront what your past self was doing there, and decide to split it or consciously keep it.

Scoring

score = degree * (1 + ageDays / freshnessHalfLifeDays)

• degree is backlinks + outgoing links. Backlinks are counted the same way as Obsidian's backlink pane (total linked mentions). Links to media attachments (images, audio, video, PDF) and self-links are excluded.
• A note left untouched for one half-life counts double. Older and denser notes rank first.

Two modes

Both are available from the command palette:

• Confront one (一件と向き合う) — shows only the single highest-scoring note. A light, everyday pass for spare moments.
• Confront several (数件と向き合う) — shows the top N notes for a focused tidying session.

Click a result to open it in place (the modal closes). Cmd/Ctrl+click opens it in a new tab and keeps the modal open, so you can keep triaging — the same gesture as a browser.

Settings

Requires Obsidian 1.8.7 or newer.

Installation

Community plugins

Available in the Obsidian community plugin directory. In Obsidian, go to Settings → Community plugins → Browse, search for "Katazuke", install, and enable.

BRAT (beta)

To track pre-release builds, install BRAT and add this repository (DaisukeMiyazaki/katazuke) as a beta plugin.

Manual

Download main.js, manifest.json, and styles.css from the latest release into your vault's .obsidian/plugins/katazuke/ folder, then enable the plugin in Settings → Community plugins.

What it accesses

Katazuke is read-only and works entirely offline.

• Reads the paths of every note in the vault, the resolved link graph, each note's last-modified time, and note tags — all needed to score notes by degree and freshness.
• Makes no network requests. Nothing leaves your vault.
• Does not read or write the clipboard, and never modifies your notes.
• The only data it writes is its own settings, through Obsidian's plugin data API.

Development

npm install
npm test        # vitest — pure scoring/graph logic
npm run typecheck
npm run lint    # eslint-plugin-obsidianmd — mirrors the directory's review
npm run build   # bundles main.js

The scoring and link-graph logic lives in src/lib.ts as pure functions and is covered by unit tests; src/main.ts holds the Obsidian integration (commands, modal, settings).

Roadmap

• In batch mode, group notes by shared link target so you can face a whole past "theme" at once, not isolated notes.
• Record the split / keep decision in place, for a more lint-like workflow.

Support

Katazuke is free and open source (MIT) for everyone, personal and commercial use alike. If it earns its place in your commercial workflow, please consider sponsoring its upkeep — it is entirely voluntary, but it keeps the plugin maintained.

• GitHub Sponsors

License

MIT — see LICENSE.