01 · Setup
Install and open
- Download the disk image from the download page.
- Open it and drag Linelark Finder++ into Applications.
- Eject the image, then open the app from Applications or Spotlight.
The build is Developer ID signed and Apple-notarized, with the notarization ticket stapled to the image, so there is no right-click-to-open step and no security warning to click past.
shasum -a 256 Linelark-Finder-Plus-Plus-1.4.0.dmgExpected: f137ca2d0e2335ee1948ad82d153bbd4dbeb1ba4a66997c3ae73ae83b664125aThe app updates itself: an update button appears in the toolbar when a newer version is published, downloads it, checks its checksum and Developer ID signature, then swaps it in for the running copy and reopens it. Versions before 0.8.0 need one manual download, and the changelog says what changed.
02 · Start
First run
The window opens on your home folder with the sidebar on the left, the file view in the middle and the path trail along the bottom. From 0.5.0 it reopens where you left off instead — the last real folder, the view mode, and which panels were open.
The first time you open a folder macOS protects — Desktop, Documents, Downloads, or a removable volume — the system asks whether to allow it. That prompt is macOS, not this app. Declining only hides that folder from the app; nothing else changes and you can grant it later in System Settings.
macOS goes on handing the Desktop, double-clicks from other apps and everything else to Finder. This is an app you open when you want it, not a system component.
03 · Look
The four views
⌘1 Icons · ⌘2 List · ⌘3 Columns · ⌘4 Gallery, or the segmented control in the toolbar. Folders sort before files, then by name, using the system’s own ordering.
- Icon and Gallery draw Quick Look previews of the files themselves rather than the generic type icon. A file is thumbnailed once and shared between the two, so switching does not regenerate what is on screen.
- In the list view, click Name, Date Modified or Size to sort by that column and click again to reverse it. Navigating somewhere new resets to the natural order; reloading the folder you are in keeps your sort.
- ⇧⌘. shows hidden files in the file views. The sidebar’s tree does not answer to it, so a favourite’s chevron still reflects only its visible contents.
- Space Quick Looks the selection, Escape closes it.
- In the list view every folder has a disclosure triangle: → opens it and ← closes it, so you can read what is inside without leaving where you are. Four buttons beside Back and Forward close every folder, close the deepest open level, open one more level, or open everything; pressing the close or open button again takes the tree one level further. Opening everything is read in the background, stops after 10,000 entries with a note on the status line, and never follows a link to a folder. A folder you open is read when you open it and again on a reload (⌘R, or any file operation here); a change made inside it by another app shows then.
05 · Find
Filter and search
These are two different things and the difference matters.
⌘F puts the keyboard in the toolbar field. Typing there filters the folder on screen by name, on every keystroke, and in the list view it reaches into the folders you have opened too, keeping the open folders that lead to a match. Return settles on the plain filter of the folder’s own items. Emptying the field puts the folder back. Nothing leaves the folder you are in, and closed folders are not searched.
A list drops below the field offering the searches filtering cannot answer: names or contents, in this folder’s tree or across the whole Mac, plus the kind of file the word suggests. ↑ ↓ move through them, Return runs the highlighted one, Escape puts the list away.
A search runs through Spotlight and shows its results in place of the folder. At most 1000 files come back, nothing can be created in them or pasted into them, and they are only as good as the index behind them. Emptying the field restores the folder.
06 · Act
Moving files safely
This is the part to read before pointing the app at files you care about.
Cut and move
Control-X or ⌘X marks the selection for moving and Control-V moves it into the current folder; ⌥⌘V does the same. Cut items appear faded, and Escape cancels a pending cut while the file view has focus. ⌘X still cuts text as usual while a field is being edited — the file shortcuts only act when a file view has focus.
A cut is internal to this app rather than the system clipboard, and files stay where they are until you paste. When a name already exists at the destination you are asked: Keep Both, Replace, Skip or Stop, with Apply to All for the rest of the operation. Replace puts the old version in the Trash and remembers where, so Help ▸ Find Previous Versions can find it again after a relaunch. A skipped item stays pending so you can paste again.
Drag and drop
Dragging works in all four views, between folders, windows and disks. Within one disk a drag moves; onto another disk it copies. Hold ⌥ to copy or ⌘ to move; the cursor shows which. Hovering over a folder for a moment opens it (not in the column view), so you can drop several levels down in one gesture.
What undo covers
⌘Z and ⇧⌘Z reverse a move, copy, duplicate, rename, New Folder, compress, Make Alias and Move to Trash, in the window where you did it. Undo checks each item first and never overwrites a name that is taken. If you changed an item since — typed into a new file, put things in a new folder — it is left alone until you choose Undo Anyway. The history lasts for the session only.
Undoing a creation, a copy or a compress moves the result to the Trash rather than deleting it outright, and redo moves those exact items back.
A move to another volume copies, compares the copy with the original, and only then removes the original, so an unplugged or full drive leaves the original where it was. When a transfer is only partly successful a sheet lists what was completed, skipped, failed and not attempted. It is not a resumable transfer engine.
Long operations
A move or copy large enough to be worth watching runs off the main thread with a count, bytes within the current file, and a Cancel button. Quitting, or closing a window, while one is in flight asks first rather than silently refusing.
The rest of the menu
⇧⌘N new folder · Return rename · ⌘D duplicate · ⌘⌫ move to Trash · ⌘C / ⌘V copy and paste · ⌘A select all · ⌘R refresh. File ▸ Rename Multiple Items… previews every new name and flags conflicts before anything changes. Show Package Contents opens an app as a folder, and ⇧⌘P shows a preview pane beside the list or columns.
07 · Shell
The terminal panel
Control-` opens a shell below the file list, started in the directory on screen with your own login shell. It is a real shell, not a simulated command box: commands have exactly the access and the consequences they would have in Terminal.app.
Change folder in the browser and restart the panel to follow it, or right-click a crumb in the path trail and point the terminal at that folder directly.
The folder view watches the disk, so a file written by a command in this panel appears above it within about half a second.
08 · Agents
Claude and Codex
A right-hand dock runs the claude and codex commands already installed on your Mac, each started in the folder being browsed and each restartable on its own.
- Neither is bundled. The app ships no copy of either tool and carries no account of its own — it runs what is on your PATH, as you, with your own credentials.
- If a command is not installed, that panel says so rather than failing silently.
- They are optional. The browser and the terminal work whether or not either is present.
09 · Understand
Rows that are queries
Several sidebar rows look like folders and are not. Knowing which is which explains most of the app’s surprising behaviour.
Recents, Shared and each tag row are Spotlight queries — the same ones Finder’s own rows are built on. The app therefore keeps no history of its own and records nothing when you open a file.
- Each is read when you open it and re-read on ⌘R, not continuously like a folder.
- Nothing can be created in one or pasted into one.
- Recents shows at most the 500 most recent files; Shared and each tag at most 1000 items.
- If Spotlight is off, or a volume is not indexed, the list is simply empty.
The Trash and Full Disk Access
~/.Trash sits behind Full Disk Access, and no app can ask for that permission — you grant it in System Settings ▸ Privacy & Security ▸ Full Disk Access or not at all.
Without it, the Trash row hands the Trash to Finder. With it, the row lists the Trash like any other folder — only this Mac’s, not the .Trashes of every mounted volume that Finder merges into one row — and Put Back returns what this app trashed, after a relaunch too, in your Trash and in a disk’s own. Settings ▸ Access shows whether it is on. Items Finder trashed can only be put back from Finder: macOS keeps their original location to itself.
What is deliberately missing
There are no AirDrop or Network rows. Neither is a folder, neither has a public API, and the URLs Finder’s own rows once opened are ignored on current macOS — so the app offers no row that would do nothing. Sending files by AirDrop still works from Share… in the contextual menu.
10 · Keyboard
Every shortcut
Command shortcuts inside the path field, the search field and an inline rename keep their normal text-editing behaviour.
11 · Edges
What it will not do
The same list the product page carries, in one place, because the useful question about a new app is what it still cannot do.
- Undo covers move, copy, duplicate, rename, new folder, compress, Make Alias and Move to Trash, for the session and per window.
- A cut is internal to the app, and a name that already exists at the destination always asks.
- Search results are capped at 1000 files and cannot be written into.
- Recents, Shared and the tags are Spotlight queries, re-read on ⌘R only.
- Folders opened in the list are read when opened and on a reload; only the folder on screen is watched. Opening everything stops after 10,000 entries.
- The Trash opens in Finder unless you have granted Full Disk Access; Put Back cannot see what Finder trashed.
- No AirDrop or Network rows.
- Cross-volume moves are not resumable, and FAT, exFAT and network volumes cannot keep permissions or extended attributes.
- Drives and servers were tried against disk images and a local SMB share, not yet against a NAS or a physical external drive.
- The app has not been checked with VoiceOver or Full Keyboard Access, or run by hand on an Intel Mac or on macOS 14.
- It does not replace Finder and does not integrate as a Finder substitute.
12 · Resolve
Troubleshooting
- The Trash row opens Finder instead of listing anything.
- That is the expected behaviour without Full Disk Access, which no app can request. Grant it in System Settings ▸ Privacy & Security ▸ Full Disk Access and the row lists the Trash in place.
- Recents, Shared or a tag row is empty.
- All three are Spotlight queries. If the index is off, still building, or the volume is not indexed, there is nothing to return. Nothing is wrong with the folder itself.
- A folder I know exists is not in the list.
- It may be hidden. Press ⇧⌘. to show hidden files. If it is inside Desktop, Documents, Downloads or a removable volume, macOS may be withholding it — check Privacy & Security.
- The Claude or Codex panel says the command is missing.
- The app runs the
claudeandcodexalready installed on your Mac and bundles neither. Install the one you want and make sure a login shell finds it on PATH. - A search returned fewer results than I expected.
- Search results are capped at 1000 files, and content searches depend entirely on what Spotlight has indexed.
- I cannot paste into what I am looking at.
- You are looking at a query rather than a folder — a search result, Recents, Shared or a tag. Navigate to a real folder first.
- A favourite I added in one window shows up in another.
- Favorites are shared by every window and tab; everything else — the folder, history, selection, view and terminal — belongs to the window.
- Something else went wrong.
- Reports are how it gets better. Send one with your macOS version, your Mac, the steps and what happened instead.
