CLI tool
FuzzyIdeas/Cling avatar
FuzzyIdeas/Cling

Cling: fuzzy file search on macOS that ends in an action, not a list

Instant fuzzy find any file on macOS

929 stars39 forksSwiftGPL-3.0

At a glance

What is it?
Cling is a macOS SwiftUI app that finds files by approximate name across indexed scopes and lets you act on the result immediately, through hotkeys, scripts, drag and drop or an Alfred and Raycast integration. The search is free for four scopes, the rest sits behind a one time Pro licence, and the public repository carries a notice that commits have been paused.
Who is it for?
Cling fits a Mac user who knows roughly what a file is called, wants it in under a second, and wants to open, copy or share it without leaving the keyboard. Skip it if you are searching by metadata, content or complex expressions, since the README states plainly that it is not built for that, and skip it on a shared or managed Mac where installing an indexer is not an option.
Can I use it commercially?
Yes, with conditions. GPL-3.0 is a copyleft licence: if you distribute software that includes it, you must release that software's source code under the same licence. Running it internally without distributing it does not trigger that obligation.
Is it still maintained?
Yes. The repository last received commits 3 days ago.
What is it written in?
Mainly Swift, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on October 22, 2026, and from our analysis. They are not legal advice.

Editorial analysis

Search by approximate name, then act on the file immediately

Cling describes itself in one line, instant fuzzy find any file, and the second half of the strapline says act on it in the same instant. That second half is the design decision that separates it from everything else in the category. The README is explicit that Cling is not an app for finding all files that match a complex query. It is for roughly knowing a name, finding one or a few candidates, and then doing something with them: copying the file to paste into chat, putting it on a shelf, opening it in a chosen editor or terminal, uploading it, or running a script against it. The person who benefits is a developer or designer on a Mac with a large disk and a habit of typing a few letters of a filename. The features list backs this up: a search bar that floats over any app like Spotlight, an app launcher inside that bar, quick filters for Images, Videos, Documents, Code and PDFs, and extension aware queries such as .png icon or .pdf invoice.

The index is mapped into memory, not loaded into it

The performance story in the README is about how the index is stored rather than about a clever matching algorithm. Each search scope and each drive has its own index saved as a file on disk, and Cling maps those files into memory instead of reading them in, so macOS loads the pages a search needs and drops them again when it needs the room. A loaded index is said to add almost nothing to memory until something changes it. What does count is the cost of writes: a file change rewrites the few pages holding that file, the first change also builds a lookup table of a few megabytes for a scope with a few hundred thousand files, the extension table shared by every index is usually under 10 MB, and search buffers return to the system when a search finishes. The stated figures are that Cling uses between 60 and 100 MB of memory with 1.6 million files indexed, and that a fuzzy search across millions of files completes in under 100 ms. Live filesystem tracking runs through FSEvents, and the index size view shows how many files each scope and folder adds, with the ability to prune what you do not need.

Installing the app and picking the first scope

Two installation paths are documented. You can download the app from the website and drag it into your Applications folder, or install the cask if you use Homebrew:

bash
brew install --cask thelowtechguys-cling

The site also links the disk image directly. Once the app is running, the decision that matters is which search scopes are enabled. The free mode covers Home, Library, Cloud Storage and Applications, and Cling starts with a 14-day free trial automatically, with no payment details needed, before dropping into free mode. Scopes can be restricted per folder, and .fsignore files are supported so you can exclude paths the way a developer expects. There is also a searchable history with Up and Down arrow cycling, Tab completion and Cmd+Down to browse everything, and the app shows your most recently changed files as smart defaults when it launches. On a first run, start with Home alone, confirm that search feels immediate, and only then widen the scope, because every extra scope is more pages to map and more files to index.

What the Pro licence actually unlocks

The split between free and Pro is unusually specific, which makes it easy to judge. A Cling Pro licence costs €15 as a one-time purchase for life, activates on up to five personal Mac devices, and deactivates the oldest device automatically when a sixth is activated, so the licence survives machine changes. What Pro adds: the System and Root search scopes, external volume indexing with persistent indexes that keep working when a drive is unmounted, an External drives filter that tells you which drive holds a file, the Everything index covering every file on local disks with no ignore rules, a file server that lets you search this Mac and download its files from a browser on a phone or another computer, custom folder filters, scripts that run custom actions on files, and a result cap of 10,000 against 500 in free mode. The Everything index is the memory story worth reading twice: it stays on disk until you turn it on and leaves memory ten minutes after you switch it off or close the window.

Cling against Spotlight, Alfred, Raycast and the metadata search apps

The README draws two different comparisons, and the distinction matters. Against Spotlight, Alfred and Raycast it claims three differences: fuzzy matching that finds files from partial or misspelled queries, the ability to search system files, hidden files, dotfiles and app data that the Spotlight index leaves out, and extension filtering that narrows results by type without a complicated expression. Against ProFind, HoudahSpot, EasyFind, Tembo and Find Any File it says something different and more useful. Those are file search apps built for advanced search features, letting you craft complex queries using metadata and file content to dig deep into the filesystem and find as many files as possible. Cling is deliberately the opposite, a tool for quickly finding one or a few specific files and acting on them at once. If your real workflow needs to find every file matching a set of metadata conditions, Cling is the wrong shape of tool and you will end up fighting its result cap of 500.

Alfred, Raycast, a CLI and an MCP server in one app

Cling does not want to own your launch surface. It ships an Alfred workflow that fuzzy searches files with the cl prefix, opens them in the editor, terminal or shelf app configured in Cling, and reindexes with clreindex, installed from Settings > General inside Cling. There is a Raycast extension for searching files, acting on them and saving often used queries from inside Raycast. On top of that there is a CLI tool for terminal based searching and an MCP server that lets an AI agent search, explain why a file is missing, and change indexes, ignore rules, filters and settings. That last one is the most unusual piece. An agent that can inspect and modify the search configuration is genuinely useful for debugging a missing file, and it is also a reason to read what you are granting. Other platform surfaces are worth noting too: cloud storage search covers iCloud Drive, Dropbox and Google Drive folders, files kept online only are included without downloading them, and files can be shared over an encrypted, auto-expiring link.

A GPL-3.0 repository with a notice that commits have paused

Two facts about the state of the project deserve to sit together. The repository is licensed under GPL-3.0, which is unusual for a commercial macOS app that also sells a Pro licence, and a legal reading of what that means for redistribution or modification is yours to arrange rather than something to assume. Then there is the warning at the very top of the README: commits to the repository have been paused because of blatant stealing, and work will continue privately. At the same time the last push was on 2026-10-20, with v3.3.2 released the same day, v3.3.1 on 2026-10-16 and v3.3.0 on 2026-10-16, so the public tree is not frozen in any obvious way. The practical reading is that the public history may stop being a reliable record of how the product develops, and that any plan which depends on building from this repository carries more risk than one that depends on the shipped application. The CHANGELOG.md and ReleaseNotes/ directories in the repository are the better record of what changed.

Editorial conclusion

Cling fits a Mac user who knows roughly what a file is called, wants it in under a second, and wants to open, copy or share it without leaving the keyboard. Skip it if you are searching by metadata, content or complex expressions, since the README states plainly that it is not built for that, and skip it on a shared or managed Mac where installing an indexer is not an option. Before adopting, read the warning at the top of the README about paused commits and work continuing privately, install the free mode from the Homebrew cask first, and check the index size view to see how many files each scope adds before you turn on the Everything index.

Frequently asked questions

How do I install Cling on macOS?

Download the app from the website and drag it into your Applications folder, or install the Homebrew cask with brew install --cask thelowtechguys-cling. The app is a native Swift and SwiftUI build for macOS only.

What is free and what does Cling Pro cost?

Free mode covers the Home, Library, Cloud Storage and Applications scopes with up to 500 results, and Cling starts with a 14-day free trial automatically with no payment details. Pro is a one time €15 purchase for life on up to five personal Mac devices, adding System and Root scopes, external volume indexing, the Everything index, a file server, custom filters, scripts and up to 10,000 results.

How does Cling search so many files without using a lot of memory?

Each scope and drive has its own index file on disk, and Cling maps those files into memory instead of reading them, so macOS loads only the pages a search needs. The README states Cling uses between 60 and 100 MB of memory with 1.6 million files indexed.

Is Cling a replacement for Spotlight, Alfred or Raycast?

The README compares Cling with Spotlight, Alfred and Raycast on fuzzy search, access to system and hidden files, and extension filtering. It positions Cling differently from metadata query tools such as ProFind or HoudahSpot, stating that it is not an app for finding all files that match a complex query.

Can Cling be used from the terminal or from an AI agent?

Yes. Cling ships a CLI tool for terminal based searching and an MCP server that lets an agent search, explain why a file is missing and change indexes, ignore rules, filters and settings. There is also an Alfred workflow using cl and clreindex and a Raycast extension.

Official sources

  1. FuzzyIdeas/Cling on GitHub
  2. License: GPL-3.0
  3. Project website
  4. README
  5. Releases
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/fuzzyideas-cling.svg)](https://hysenlabs.com/projects/fuzzyideas-cling)

Was this useful?