History
Rename History
Every rename is saved with timestamp, original name, new name and the AI provider used (SwiftData). The history is accessible from the sidebar.
The history also powers duplicate detection: files with an active history entry are skipped automatically when processed again. After reverting, the file counts as new and will be suggested again on the next run.
Search and Filter
The search field searches both original and new file names. The “Reverted only” toggle in the bottom bar restricts the list to renames that have already been reverted; when it is off, all entries are shown. The number of visible entries is displayed next to it.
Reverting
Click Revert on a history entry to rename the file back to its original name. The entry is marked as reverted. This feature is also available via the REST API.
Reverting requires the file to still exist under its new name in its original location. If it has since been moved, deleted or renamed again, the entry cannot be reverted. If another file now occupies the old name, it is left untouched; Distill tells you why instead of overwriting it.
Reverting many renames at once
Since version 1.3.6 you can revert any number of renames in one pass, for example after changing your rules so you can rename the files again:
- Selection: Select several entries (click with ⇧ or ⌘, ⌘A for all) and choose “Revert Selected (n)” from the context menu.
- Everything shown: The “Revert All Shown…” button in the bottom bar reverts every entry the list currently displays. A search term narrows the set, so you can revert only the renames of one folder or one keyword.
Distill asks for confirmation and then works through the entries from the newest rename to the oldest. This also unwinds chains where a file was renamed several times. Afterwards a summary shows how many entries were reverted and how many were skipped, with a reason for each skipped entry (file missing, old name taken, already reverted). A skipped entry does not stop the others.
The summary offers to rename the reverted files right away with the current rules: “Rename Automatically” puts them in the queue and renames them without further confirmation; “Review Suggestions” adds them as suggestions in the Files tab, where you check each name before applying. Both cost one credit per file, or one call to your own AI provider. “Close” leaves the files under their original names.
Via the REST API, POST /v1/revert accepts ids or a date range from/to to revert several entries; the MCP tool revert_rename accepts paths or from/to.
Export
Use the “Export” menu in the bottom bar of the history view to save the history as CSV (semicolon-separated) or JSON. The export contains the entries currently displayed — an active search or the “Reverted only” toggle also narrows the export.