WhereIs needs macOS 26 or later on a Mac with Apple silicon. The companion app for iPhone and iPad needs iOS 26 or iPadOS 26 or later. To replay the built-in tour at any time, choose Help › WhereIs Tutorial.
Getting started
- Create a shelf: click + in the toolbar or press ⌃N, type a name and press Return.
- Add files: drag files or folders from Finder onto a shelf, or press ⌘O. A shelf keeps references, so your originals never move.
- Open and preview: double-click an item to open the original. Right-click it for Show in Finder, copy, compress, extract, pin and more.
- Organize: click a shelf’s label to rename it; drag the label to reorder or pin the shelf. Each shelf sorts by hand, name, last opened, or AI-created first.
- Find: press ⌘F to search every shelf.
Plans and organizing
- Tags and a description: point at a shelf’s name and use the buttons that appear, or the shelf’s ⋯ menu. A shelf holds up to five tags; click a tag to edit it.
- Deadline (WhereIs Pro): choose Add Deadline to set a start, a due time and reminders. Click the bar beside the name to edit it, mark it done or remove it; right-click it to postpone. Turn reminders off for a Mac in Settings › General › Deadlines.
- To-dos (WhereIs Pro): choose Add To-Dos, then click To-Do beside the name. Space adds a to-do, Return opens it, ⌘K checks it off; checked ones move to the Logbook after three seconds. Turning the list off asks whether to delete the to-dos or keep them hidden.
- Virtual folders: select items and press ⇧⌘G, or right-click an empty part of a shelf and choose New Virtual Folder…. Nothing moves on disk. The free version holds two virtual folders; WhereIs Pro has no limit.
- Unassigned shelf: in Finder or another app, choose Share › Add to Unassigned Shelf. Press ⇧⌘I to show the panel, then drag items onto shelves. Hold Control while dragging to copy instead of move.
- Select and highlight: ⌘-click, ⇧-click, ⌘A or drag a box to select several items. Right-click › Highlight marks them in one of seven colors.
Files and access
- A file was moved or renamed: WhereIs follows it automatically. If it was deleted or can’t be found, right-click it and choose Locate File….
- Shelves on another Mac: each Mac grants its own file access. For files in iCloud Drive, open Settings and choose Connect iCloud Drive Folder… once. Files that only exist on another Mac show as unavailable until you locate a copy on this Mac.
- Removing vs. deleting: removing an item from a shelf only removes the reference. Moving an item to the Trash always asks first.
iCloud sync
- Sign in to iCloud in System Settings on each Mac. WhereIs syncs shelves and references through your private iCloud; it doesn’t upload file contents.
- The sidebar shows the sync status and the last save time. To retry, open Settings and click Sync Now.
- If you sign in with a different Apple Account, sync pauses to keep the two libraries apart. Sign back in to the original account to resume. Your local library is never deleted.
iPhone and iPad
- Works with your Mac: WhereIs for iPhone and iPad is a companion to WhereIs for Mac. Sign in to iCloud with the same Apple Account on each device, and your shelves, references, deadlines, to-dos and tags sync through your private iCloud.
- Files stay on your Mac: add files on the Mac. On the phone you see each file’s name, where it lives and where it came from; files can’t be opened, previewed or downloaded there.
- On the go: create shelves, edit descriptions and tags, plan deadlines and to-dos, and pin, highlight, group or move references. Changes reach your Mac the next time it syncs.
- App lock, reminders and widgets: lock WhereIs with Face ID, Touch ID or your passcode in Settings. Reminders are scheduled on each device, and the Deadlines and To-Dos widgets can be added from the Home Screen.
- WhereIs Pro: one membership works on your Mac, iPhone and iPad with the same Apple Account. On a new device, tap Restore Purchases in Settings.
WhereIs Pro and purchases
- Restore: choose WhereIs › WhereIs Pro…, or open Settings, and click Restore Purchases. Use the same Apple Account you bought with.
- Cancel or change a subscription: open Settings › Membership… › Manage Subscription, or go to your subscriptions in the App Store. Cancel at least 24 hours before the period ends to avoid renewal.
- Lifetime and an existing subscription: buying Lifetime doesn’t cancel a subscription. Turn off its renewal in the App Store.
- Refunds: Apple handles App Store payments and refunds. Request one at reportaproblem.apple.com.
- If membership ends: nothing is deleted. Free limits (3 shelves, 20 items each, 2 virtual folders) apply only to new additions. Existing deadlines and to-dos stay and still remind you; you can check them off, mark them done, remove or hide them, but adding and editing need WhereIs Pro.
Copy, move, ZIP and undo (WhereIs Pro)
- From a shelf’s ⋯ menu, copy or move every file into a new folder, or compress them into one ZIP. You always choose the destination first, and existing files are never replaced.
- Choose Undo Last Move… to restore a shelf’s last move, keeping the copies or moving the files back. Each shelf keeps its own undo, even after a restart.
- If a move was interrupted, choose Continue Interrupted Move… from the same menu. Finishing it never requires Pro.
Claude Code and Codex (WhereIs Pro)
- Choose an AI workspace location in Settings › AI Agents. Each shelf then gets its own folder there.
- Drag a shelf’s label onto Claude or Codex in the Dock, or use the shelf’s ⋯ menu › AI Workspace. The first time, approve the project in that app’s trust prompt.
- For the Codex app without the command line, Settings › AI Agents shows the MCP command and argument to add under Codex’s MCP servers.
- To hide the agent logos on files, turn off Show AI Badges on Files in Settings › AI Agents.
- What agents can do: set Settings › AI Agents › Agent Permissions to Search and Read Only, Organize Shelves, or Organize, Ask Before File Changes. Renaming originals, making copies, exporting and archiving wait at the bottom of the window: Deny, Allow, or Allow for 15 Minutes.
- Undo an agent’s change: click Undo on the notice at the top of the window, or use Recent AI changes in Settings › AI Agents.
- Claude desktop app: in Settings › AI Agents, choose Export Extension… and open the WhereIs.mcpb file to add it to Claude.
- Claude Code, Codex and their accounts are separate products; WhereIs doesn’t include AI credits.
Your data
WhereIs has no account and no server of its own. See the Privacy Policy for what’s stored where, and how to delete it.