# Cirrus

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

> This is the Markdown version of the Cirrus page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/cirrus>

- **Latest version**: `1.17,2026.10`
- **Developer**: Howard Oakley
- **Homepage**: <https://eclecticlight.co/cirrus-bailiff/>
- **Categories**: [Files and Storage](https://opennavo.com/categories/files-storage)
- **Install**: `brew install --cask cirrus`
- **30-day installs**: 10
- **Homebrew**: Available; updated by Homebrew
- **Download URL**: <https://eclecticlight.co/wp-content/uploads/2026/10/cirrus117.zip>
- **SHA-256**: `ac50ab7223fc3a1f95538c9639cd1ff56a4be0aae17e9a8f5368f74309418ab8`

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "app": [
        "cirrus117/Cirrus.app"
      ],
      "target": "/Applications/Cirrus.app"
    },
    "phase": "install",
    "sources": [
      "cirrus117/Cirrus.app"
    ],
    "target": "/Applications/Cirrus.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/co.eclecticlight.cirrusmac.sfl*",
            "~/Library/Caches/co.eclecticlight.CirrusMac",
            "~/Library/HTTPStorages/co.eclecticlight.CirrusMac",
            "~/Library/Preferences/co.eclecticlight.CirrusMac.plist",
            "~/Library/Saved Application State/co.eclecticlight.CirrusMac.savedState"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 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

## System requirements

- macOS 14 or later · Version: 1.17,2026.10 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cirrus.rb> · Checked 2026-11-22
  - <https://eclecticlight.co/wp-content/uploads/2026/10/cirrus117.zip>
  - SHA-256: `ac50ab7223fc3a1f95538c9639cd1ff56a4be0aae17e9a8f5368f74309418ab8`
- macOS 14 or later · Version: 1.17,2026.10 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cirrus.rb> · Checked 2026-11-22
  - <https://eclecticlight.co/wp-content/uploads/2026/10/cirrus117.zip>
  - SHA-256: `ac50ab7223fc3a1f95538c9639cd1ff56a4be0aae17e9a8f5368f74309418ab8`

## Uninstall

- `brew uninstall --cask cirrus`

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

### Deep clean (optional)

- `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`.

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

- Files and folders: `~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/co.eclecticlight.cirrusmac.sfl*` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cirrus.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Caches/co.eclecticlight.CirrusMac` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cirrus.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/HTTPStorages/co.eclecticlight.CirrusMac` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cirrus.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/co.eclecticlight.CirrusMac.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cirrus.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Saved Application State/co.eclecticlight.CirrusMac.savedState` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cirrus.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 1.17,2026.10

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

These changes come from CirrusHelp.pdf bundled in the official Cirrus 1.17 archive selected by Homebrew (1.17,2026.10), whose SHA-256 matches the cask:

- Remove redundant File/Open commands.
- Add a pinning indicator to the browser.
- Modernize the log browser controls.
- Rewrite the Help file as a PDF book.

The change list is dated 13 October 2026. This is the documented change-list date, not a separately verified publication timestamp for the archive.

#### Official sources

- [https://eclecticlight.co/wp-content/uploads/2026/10/cirrus117.zip](https://eclecticlight.co/wp-content/uploads/2026/10/cirrus117.zip)
- [https://eclecticlight.co/cirrus-bailiff/](https://eclecticlight.co/cirrus-bailiff/)
- [https://raw.githubusercontent.com/hoakleyelc/updates/master/eclecticapps.plist](https://raw.githubusercontent.com/hoakleyelc/updates/master/eclecticapps.plist)

## Facts and sources

- <https://opennavo.com/apps/cirrus>
- <https://opennavo.com/apps/cirrus/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cirrus.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/cirrus>
