hazelnut

hazelnut [command] [options]hazelnutd [options]

hazelnut is a terminal-based automated file organizer inspired by Hazel for macOS. It watches folders and organizes files based on user-defined rules. The tool consists of two components: a TUI for creating and managing rules interactively, and a daemon (hazelnutd) that runs in the background applying rules continuously.Rules are defined in human-readable TOML configuration files and can trigger actions like moving, copying, renaming, archiving, deleting, trashing, or running custom commands on matched files. Matching conditions include file extension, name pattern, size, and age.

init

Initialize a new configuration file.

List all configured rules.

Dry-run or apply rules on a directory.

Check for updates.

Specify a custom config file.

Specify a directory to process (used with run).

Apply rules instead of dry-running (used with run).

Rules are stored in TOML config files. Each rule specifies a watch folder, file matching conditions (by extension, name pattern, size, age), and actions to perform. Multiple rules can match the same file and all matching rules execute in order.

The daemon (hazelnutd) is only available on macOS and Linux; on Windows only the TUI is available. File watching relies on OS-level filesystem notification APIs, which may have limitations on certain filesystems.

hazelnut was created by Ricardo Dantas and is written in Rust using the Ratatui TUI library. It was inspired by the popular macOS automation app Hazel, bringing similar file organization capabilities to the terminal.

watch(1), find(1), mv(1)