Support

Caddy Docs for macOS · Version 1.0

Write to me. One person made Caddy and the same person answers the mail, so you will hear back from a human being rather than a queue.

Email support

blake@caddydocs.com

It helps to include your macOS version, your Caddy version (the flag in the menu bar, then Settings, then General), and what you were doing when it went wrong. A screenshot is worth a paragraph.

Finding Caddy

There is no window and no Dock icon

Caddy lives in the menu bar as a small flag, and on the edges of your screen as colored tabs. That is the whole app. If you have just installed it and cannot see anything, look at the right edge of your main display and at the menu bar.

The first launch

Caddy opens a Sample Caddy on the right edge with four bundled example documents, so there is something to look at straight away. Later launches start collapsed, with the tab still on the right edge. Click it.

The flag menu

The flag in the menu bar holds Show and Hide, New Caddy, Saved Caddies, Settings and Quit Caddy.

The basics

  • Open a Caddy: click its tab. Click the tab again, or press esc or ⌘W, to put it away.
  • Move a tab: drag it along its edge. Pull it away from the edge and it comes with you; drop it on another edge, or throw it and let it land.
  • Add documents: the + button, drag and drop onto an open Caddy, or Finder, then Open With, then Caddy.
  • Show or hide every Caddy: ⌃⌥C. New Caddy: ⌃⌥N. Hide the Caddies on the display you are looking at: ⌃⌥H.
  • Quit: from the flag menu. ⌘Q works when a Caddy has focus.

Common questions

A file in my Library says Missing

Caddy remembers your documents by reference, not by copying them, so a file that has been renamed, moved to another folder, or put on a drive that is currently unplugged shows as Missing. Click Locate… and point Caddy at the file once; it will remember the new place from then on. If the file is on an external drive, plug the drive back in and reopen the Caddy, and it will heal itself with no action from you.

My Caddies did not come back after a restart

They should. If a Caddy opens but its documents read as Missing, use Locate… once on the first one. If a whole Caddy is gone, check Saved Caddies in the flag menu, which is where a Caddy goes when you use Save & Close.

Caddy is covering something I need to see

Press ⌃⌥H to hide the Caddies on that display, or ⌃⌥C to hide all of them. Note that ⌘H deliberately does not hide the tabs, because they are meant to stay reachable next to a full-screen document.

How do I turn the floating physics on or off?

No Gravity Caddy is in the flag menu. It is off by default. Turning it off again sends every tab home to the edge it came from. If macOS is set to Reduce Motion, No Gravity pauses on its own.

Does Caddy change my documents?

No. Caddy reads your files where they live and never writes to them. Editing happens in the app that owns the file, through Open in Word or Open in Preview.

Where is my data, and how do I remove it?

Everything Caddy stores is inside its own sandbox container at ~/Library/Containers/com.caddydocs.Caddy. Deleting the app and then that folder removes every trace of Caddy from your Mac. Your documents are untouched, because Caddy never held copies of them. See the privacy policy for the full account.

Something is genuinely broken

Please tell me. Bugs get fixed faster when I can reproduce them, so the steps you took matter more than anything else you can send.

Requirements

macOS 15 or later. Universal, so it runs natively on Apple silicon and on Intel Macs.