Skip to content

Cirrus

Howard Oakley · Inspect iCloud Drive files, pinned items, upload tests and logs on macOS.

CaskFiles and Storage
Install command
brew install --cask cirrus
30-day installs
10
#2050 in App
1-year installs
166
Last 365 days
Latest version
1.17
Download size
9.8MB
zip
Release cadence
Irregular
0 releases in 30 days

About

Cirrus is a free macOS utility for investigating iCloud Drive. Version 1.17 provides detailed file and folder information, a specialized log browser, a pinned-file crawler reporting counts and sizes, and test uploads. Its log browser requires an administrator user for reliable log extraction.

Pinning detection recognizes the pinning extended attribute on individually pinned files; it does not recognize files pinned only through a parent folder. Version 1.17 removes the File menu and the old open/download/evict approach because of File Provider limitations. Local download and eviction controls are available in Finder. Bailiff is a separate menubar utility.

Install with brew install --cask cirrus and open Cirrus from Applications. Version 1.17 requires macOS 14 Sonoma or later, including Sequoia, Tahoe and Golden Gate. The publisher retains version 1.16 for Big Sur, Monterey and Ventura.

https://eclecticlight.co/cirrus-bailiff/ https://eclecticlight.co/2026/10/15/cirrus-1-17-an-update-for-this-unique-icloud-drive-utility/ https://raw.githubusercontent.com/Homebrew/homebrew-cask/HEAD/Casks/c/cirrus.rb

At a glance

System
macOS 14 or later
Chip
Apple silicon · Intel
Auto-updates
No
Developer
Howard Oakley
Homebrew
Available; updated by Homebrew
Also known as
cirrus
Homepage
eclecticlight.co/cirrus-bailiff
Token
cirrus

Checked

What’s new in 1.17 (2026.10)

New OpenNavo editorial

Cirrus 1.17 removes redundant commands, adds a pinning indicator, modernizes log controls, and moves Help to a PDF book.

How to install Cirrus on Mac

Homebrew installs the app in your Applications folder.

Install without Homebrew

Download the same file Homebrew uses: Install Details

Uninstall Cirrus and optional data cleanup

Uninstall command
brew uninstall --cask cirrus

A regular uninstall removes the app and keeps its settings and caches.

Deep clean (optional)
Uninstall command
brew uninstall --zap --cask cirrus

--zap also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out --zap.

Questions about Cirrus

Is Cirrus safe?

Cirrus is in Homebrew’s official catalog and has not been disabled. Since September 2026, Homebrew disables apps that fail macOS Gatekeeper checks. When installing, Homebrew checks the download from eclecticlight.co against its SHA-256 checksum. It was installed 10 times through Homebrew in the last 30 days.

How do I completely uninstall Cirrus on a Mac?

Run brew uninstall --cask cirrus. To delete its settings and caches as well, run brew uninstall --zap --cask cirrus. --zap also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out --zap. That also deletes 5 files and folders, including ~/Library/Preferences/co.eclecticlight.CirrusMac.plist.

Does Cirrus run on Apple silicon (M1 and later) Macs?

Homebrew installs it on both Apple silicon and Intel Macs, from the same download. It needs macOS 14 or later.

Where does Cirrus store its settings and data?

Its settings are in ~/Library/Preferences/co.eclecticlight.CirrusMac.plist. These locations come from Homebrew’s clean-up list.

What is the latest version of Cirrus?

The latest version is 1.17. Run brew upgrade --cask cirrus to update it.

Similar Apps

  • RenamerA macOS app for batch-renaming files with reusable workflows, live previews, and undo with file backup.
  • WhatSizeA macOS utility for measuring disk usage, exploring large files and folders, and cleaning selected space-consuming items.
  • ProFindA macOS file-search app with natural-language and Boolean queries, content search, and actions for found items.
  • JottacloudA macOS desktop client for Jottacloud cloud storage, with service features including file backup, recovery, archiving, and sharing.
Browse all apps