findDupes

README

findDupes

A command-line tool that finds duplicate files by content hash (SHA-256), searching one or more directories concurrently.

Installation

Requires Go 1.25 or later. The go.mod go directive is deliberately pinned to the oldest Go version that supports the code and its dependencies, rather than tracking the latest compiler — this keeps the requirement low for contributors without needing a documented compatibility exception each time a newer Go is released.

go install github.com/mojotx/findDupes@latest

You can also simply clone the repository and then install locally with:

go install -v ./...

This will install the findDupes binary into your ${GOBIN} directory, e.g., $HOME/go/bin.

Usage

findDupes [flags] <directory> [directory...]

Flags:

• -v, --verbose — print progress while scanning files
• -w, --workers — number of concurrent hashing workers (default: number of CPUs)
• --version — print the version number

Known CI limitations

• The CI matrix runs the race-enabled test suite on Linux, macOS, and Windows using the Go version declared in go.mod. If a runner-specific test failure appears, link the current failure and address that environment directly rather than disabling macOS tests globally.