FAQ

Why does Cmd-A type “a” in Fuzzy Mode?

Fuzzy Mode is not a normal text field. It is a command query for matching catalog items.

There is no insertion cursor or text selection range, so shortcuts like ⌘+A, ⌃+A, and ⌃+E do not mean “select all” or “move to start/end of line” there.

Use Text Mode when you want normal text editing behavior.

How do I search Google?

Create a Smart Links entry:

Name	Template
Google Search	https://www.google.com/search?q={{input}}

Then either:

• pick Google Search, choose Open Smart Link…, and type the search
• start in Text Mode, type the search, then use Send to Smart Link…

How do I find files?

Read Finding Files for the full guide.

Short version:

• add folders you use often with Add Folder… in Settings -> Sources
• use Fuzzy Mode when the file should be in Tuna’s normal index
• use Spotlight Search For… or Spotlight Search In… for one-off scoped searches
• use Smart Folders for searches you repeat

How do I get the current text selection?

Recommended: select text in another app and run the macOS Stage in Tuna service with ⌘+⎋.

You can also open Tuna and use Current Text Selection, or press ⌘+G while Tuna is open to grab the current selection as subjects while keeping pane focus where possible. Tuna needs Accessibility permission for selected text from other apps.

Read Current Selection and Meta Objects for the service, Resolve, permissions, and the differences between selection, document, and clipboard objects.

Tuna uses the app that was active before you opened the launcher. It first reads Accessibility; when page or message text is not exposed there, it can use the app’s selection service instead. This may briefly return focus to the source app. Tuna restores the launcher only if you haven’t started a newer interaction or switched elsewhere. Password fields and empty selections are not captured. Support depends on what the source app exposes through Accessibility or macOS Services.

Firefox, Developer Edition, and Nightly use Accessibility selections only. Tuna avoids their automatic Services fallback because it can return old text after a selection is cleared. If Accessibility cannot read the selection, use the explicit service or copy and paste.

If automatic acquisition is unavailable, use Stage in Tuna when available, or explicitly copy in that app and paste into Tuna with ⌘+V. The automatic service uses a private pasteboard: Current Selection does not issue Copy or substitute existing clipboard contents, and your clipboard is left untouched. The Read Selection for Tuna (Internal) service is an implementation helper; use Stage in Tuna for manual staging.

How do I get the current Finder selection?

Recommended: select files or folders in Finder and run the macOS Stage in Tuna service with ⌘+⎋.

You can also open Tuna and use Current Finder Selection. The generic Current Selection item returns Finder’s selection when Finder is active, and ⌘+G can grab it as subjects while keeping pane focus where possible. macOS may ask for Finder automation permission.

If Tuna is missing from System Settings → Privacy & Security → Automation, reopen Tuna’s onboarding and choose Grant beside Automation. Apps cannot be added to this particular macOS list by dragging them in; Tuna appears after it asks macOS for access. If you previously denied the request, expand Tuna in Automation settings and enable Finder.

How do I get the document open in another app?

Open Tuna and use Current Document. Tuna returns the file or URL reported by the focused window of the previously active app. The app must expose its document through macOS Accessibility, and Tuna needs Accessibility permission.