TunaTuna
ProDocs
ProDocs Download βeta

Changelog

Release notes and updates.

0.93

  • The new Logic Board theme turns Tuna into a dark chip on a green circuit board, with staggered
    pulses of current running through its traces when the launcher activates.
  • Search results that match a keyword, bundle name, or alias now show the winning term beneath the
    title, with the matching characters highlighted.
  • Images can now be converted to text inline with OCR or processed in the background with OCR to
    Shelf.
  • Shelf task logs can now be copied directly from the log viewer.
  • Catalogs backed by live search now default to Search while retaining Browse for recent or grouped
    items; enriched apps still default to Open and enter Search with Right Arrow.
  • Aliases now sync through config.toml, and upgrades repair aliases created with older Smart Link
    identities instead of requiring them to be reassigned.

Fixes

  • Catalog errors and empty states now appear as compact messages instead of oversized grid items.
  • Search now matches each keyword separately, preventing queries from scattering letters across
    unrelated keywords and outranking better results.
  • Selected result row borders no longer get clipped by the results pane.
  • Tuna now closes immediately when it starts a dismissing command from search or Combo Mode, while
    still reopening for commands that return a result.
  • Action preferences no longer show installed extension actions as missing because of source settings.
  • Paging through large folders now stays responsive, including folders full of images.

0.92

  • Quick Look can now preview remote catalog items that prepare a local preview on demand.

0.91

Fixes

  • Large v3 Turbo can be downloaded again after its upstream model artifact changed.
  • Search results no longer reshuffle after first appearing.
  • Browse and Search commands now reveal Tuna with their destination already open instead of briefly
    showing the staged command first.
  • Source priority controls now live under Advanced in source details instead of crowding the
    sources list.
  • Talk Mode no longer discards audio from recordings longer than five minutes, and replaces its
    listening label with the elapsed time after 30 seconds.
  • Window Management commands that reach the screen edges (Maximize, halves, thirds, …) no longer
    need several runs on systems where the app applies the move and the resize separately.

0.90

Fixes

  • Shortcuts now shows Tuna's specific error when “Stage in Tuna” cannot complete.
  • Smart Links no longer add locale separators to numeric input, so links such as GitHub pull
    requests receive 1234 instead of 1,234.

0.89

Fixes

  • Assign Alias commands no longer report success before the alias is saved.
  • Opening an app, file, or URL now dismisses Tuna immediately instead of waiting for macOS to
    finish opening it.
  • Upgrading no longer fails with a "Migrate AI provider settings" error when config.toml has an
    unrelated problem (like a hand-edited Combo Mode binding without a destination). The file is left
    untouched and reported as an invalid configuration instead.

0.88

Upgrade note: Smart Links are now identified by their name instead of internal IDs. Tuna
rewrites your saved hotkeys and Combo Mode bindings automatically, but scripts using tuna:// URLs
that embed a Smart Link's old ID must be updated, and Smart Link abbreviations and learned rankings
reset. Duplicate Smart Link names get a numeric suffix.

Configuration

  • Smart Links and Combo Mode bindings no longer carry IDs in config.toml, and custom hotkey IDs
    are optional, making the file much easier to write by hand
  • Renaming a Smart Link in Settings updates every hotkey, Combo Mode binding, and action preference
    that refers to it
  • Upgrades are more resilient: catalog names from older versions are recognized, a broken synced
    file no longer blocks the rest of the upgrade, the backup always holds the original file, and
    anything dropped is reported in more detail
  • Combo Mode import also accepts Leader Key configuration files and reports entries it could not
    convert

Intelligence

  • Applying configuration no longer wipes AI provider settings or cached model lists
  • When macOS Keychain denies access to a saved API key, Tuna now says so instead of showing
    "Not set"
  • Intelligence settings refresh when the configuration file changes while the pane is open

0.87

Intelligence

  • Intelligence settings now include provider presets and keep each provider’s API key and model
  • Model selection now loads the models available directly from the selected provider
  • API keys are now changed explicitly instead of being overwritten while editing
  • AI Agent model overrides use the same searchable provider model picker

Themes

  • Normie Bar and Nuggets now match Default’s status feedback, tint controls, staged-item presentation, and keyboard hints
  • Silly Type stays vertically centered and no longer crashes when dismissed

Catalogs

  • Tuna no longer runs periodic background catalog rescans

Fixes

  • Command setup no longer crashes when a catalog item has an invalid saved reference
  • Debug prompts copied from Runtime Logs now link directly to the configuration guide

0.86

Fixes

  • Catalog hotkeys now show results when needed without briefly flashing Tuna
  • Comma now stages the selected item while browsing a catalog

0.85

Upgrade note: This release rewrites command and configuration data again. Tuna backs up
config.toml, but older hotkeys, Combo Mode bindings, or Smart Link commands may still need repair.
The new format is intended to avoid another reset.

Logs

  • Added Runtime Logs in Settings with details, copy, export, and an AI debugging prompt
  • Startup errors now open Runtime Logs automatically

Commands

  • Hotkey, URL, and Combo Mode commands now handle results, failures, and cancellation consistently
  • The comma key once again stages multiple subjects
  • Combo Mode groups run all actions again; the builder and cheatsheets are clearer

Configuration

  • Upgrades preserve hotkeys, nested Combo Mode bindings, workflows, and general settings where
    possible
  • Invalid config and migration losses are reported instead of silently applied
  • External edits are protected, and source scope or sorting changes reload without restarting
  • Smart Links keep stable identities across future imports

Fixes

  • Improved extension field contrast and added built-in X and GIPHY icons
  • Fixed settings sheet crashes, unreliable restarts, and Talk Mode inserting into the wrong app

0.84

  • Backspace deletes search text instead of moving up while browsing nested catalogs
  • Nested extension catalogs preserve their intended list or grid layout

0.83

  • Extensions can connect directly to OAuth services such as Are.na
  • Added preview-first catalog grids and clearer loading feedback
  • Backspace and ⌘↑ move up while browsing nested catalogs
  • Dynamic action targets load and refresh only when needed
  • Fixed distinct text snippets with matching display titles being treated as the same item

0.82

  • App pickers only show applications
  • Combo Mode URL bindings use the correct Open URL action

0.81

  • Fixed migration of legacy commands
  • Update downloads now verified with signatures

0.80

Note: Upgrading from 0.78 or earlier resets action order and default-action overrides.
Everything else — hotkeys, combo bindings, sources, and scope — is kept. Reorder any actions
you had customised.

  • New native Intelligence settings pane for AI features
  • Themes can define their own window transitions
  • Talk Mode keeps your last recording
  • Fuzzy search supports symbols and ranks better
  • Faster, smoother catalog scanning and search
  • Contact entries typed as email and phone
  • Clearer catalog scope controls and simpler action ordering
  • Fixed emoji result ordering
  • Fixed arrow keys typing into the query
  • Fixed Large Type lingering while Tuna is inactive
  • Fixed Combo Mode modifier holds and editor behavior
  • Fixed grid navigation and numpad Enter commits
  • Fixed secondary actions for text
  • Fixed "Set as Default Action" clearing instead of setting
  • Volumes now refresh after mount changes
  • Renaming an item or action no longer breaks preferences, hotkeys, scope, aliases, or URL commands
  • Sources scope rebuilt: unchecking an app no longer freezes a catalog, new apps keep appearing, and item selection (None/Some/All) is separate from including new items
  • Command builder keeps Run/Stage mode when editing and allows editing text arguments
  • Fix combo bindings made in the old builder (combo+n staging regression)
  • Config reload refreshes Custom Items without a relaunch
  • Command result history now works beyond the color picker
  • Themes no longer install from the store; third-party themes still install directly
  • Broken extension packages and malformed catalogs are rejected instead of breaking the app
  • tuna:// run/stage URLs now use query parameters (old URLs still work)

0.78

  • Add missing System Settings panes
  • Add audio I/O device catalogs
  • Improve search for GitHub, Notion, Homebrew, smart folders
  • Stream Shelf task logs
  • Fix color picker interactions
  • Fix inline prompt result display
  • Fix paste shortcut across keyboard layouts
  • Fix Last Download resolution
  • Fix combo group hotkeys
  • Discard canceled AI task failures
  • Clearer dictation AI provider errors
  • Smoother inline action loading and key affordances

0.77

  • Add configurable dictation presentation with mini HUD
  • Fix canceled and first-time dictation glitches
  • Add color picker history catalog
  • Add status menu restart option (hold opt)
  • Fix Spotlight search result provenance
  • Fix Sources "Some" item toggles

0.76

AI Prompts

  • Whether a prompt takes input is now determined by the presence of {{input}} in the prompt file.
  • AI prompts catalog is now browsable
  • AI prompt files directory now follows custom config folder setting
  • "Run Prompt" (no input) action added
  • AI prompt failures go to Shelf

Other

  • Curated apps to hide a bunch of trash
  • Stronger mnemonic scoring for search
  • Smoother action pane icon updates
  • Faster Recent Objects rebuilds
  • Polished inline command results
  • Expanded currency coverage
  • Improved dictation processing controls
  • Prev/new Space commands added
  • Fixed Shelf file drags
  • Fixed combo commands on non-Latin layouts
  • Fixed extension update prompt race condition

0.75

AI prompt extension

  • Add preset prompts or write custom inline and process them directly in Tuna
  • Use either Apple's built-in Foundation models (where available) or OpenAI API providers (BYOK style)
  • Use for dictation post processing. Pick a prompt and auto-process your dictation results. Clean up the output or turn it into pirate speak yarh!

Custom Items catalog

  • Add one-off scripts, text snippets, un-indexed files, whatever to sources

And...

  • Check for updates daily
  • Split Volumes and Network Locations from Devices
  • Fix Tuna command badge display
  • Hide Applications catalog depth setting
  • Simplify Sources detail header
  • More fixes...

0.74

Notable

  • Limited Home folder source depth to 1
    • If you want nested paths available, use custom Indexed Folders which include ignore list and type config.

Other

  • Polished command builder sheet
  • Fixed focus restore after drop
  • Fixed Accessibility target capture
  • Fixed Combo Mode app binding URLs

0.73

  • Ignore common password managers in clipboard history by default
  • Fix staged icon stack crash
  • Rewrite command builder modal
  • Resolve common actions by short name in URL/CLI
  • Fix inherited combo modifier cheatsheet
  • Fix Enter key command commits
  • Fix Run with Input ... action icon
  • Fiddle with the app icon

0.72

  • Update app icon

0.71

  • Fix incompatible extension updates
  • Update icon ... again

0.70

Note: This update combines application catalogs. There's a migration that should fix your hotkeys/actions but if they break, this is why.

  • Updated app icon
  • Stabilized dictation model catalog
  • Improved Parakeet implementation significantly
  • Unified application catalogs with browse icons
  • Redesigned theme tint picker

0.69

  • Add new Nuggets theme
  • Add TunaCalc angle conversions (deg <-> rad)
  • Fix inch unit conversion parsing
  • Fix timezone abbreviation resolution
  • Add config reload command
  • Add double-tap triggers for all launch modes
  • Add Command-W to dismiss launcher
  • Add Open in Messages action for phone numbers
  • Change Quick Look shortcut to cmd+y
  • Prefer app results over shortcuts

0.68

  • Add button for command history clearing
  • Respect clipboard exclusion flags
  • Forget action skips adding to command history
  • Onboarding shows connectivity opt-outs
  • Fix combo mode editor key capture

0.67

  • Fix dictation UI dismissal delay
  • Use commit animation for dictation success
  • Added TunaKit extension gating
  • Improved action settings labels
  • Fixed combo group fallback icons
  • Fixed add hotkey hang on macOS 15

0.66

  • Add clipboard image save to file action
  • Add ignore patterns for indexed folders
  • Improve smart link icons
  • Make Smart Folders dynamic catalogs
  • Fix Smart Folder sheet dismissal
  • Support file actions for app bundles
  • Add extension update prompt
  • Add app enrichment actions
  • Warn on legacy Pro downgrade
  • Detect email and phone in text mode
  • Classify text-mode URLs as URLs
  • Find contacts by nickname
  • Fix primary action preference ranking

0.65

  • Hold last key in query to execute a fuzzy command
  • Fixed combo cheatsheet toggle when delay was Never
  • Fixed default theme sizing jank
  • Fixed large type text wrapping
  • Improved dictation media handling
  • Add option to duck audio when dictating
  • Unified Talk Mode model management + more options

0.64

  • Improved "Show in Large Type" text action
  • New "Show in Silly Type" text action
  • Fixed application toggle activation

0.63

  • Added Tuna CLI – (see docs)
  • Fixed Smart Links action ranking
  • Fixed hotkeys pane interactions
  • Aligned shortcut recorder overlay

0.62

  • Running a command shows a different animation than dismissing
  • Slightly faster whisper dictation
  • Fixed Leader Key import description text
  • Various internal improvements

0.61

  • Make "Resolve Result" the secondary action for inline calculations
  • Fix crash in fuzzy scorer

0.60

  • PLEASE NOTE: Leader Mode renamed to Combo Mode
  • Inline calculations gain math functions and × multiplication
  • Restored down-arrow history navigation

0.59

  • Typing math operators in Fuzzy mode switches to text mode
  • Resolve Result returns unformatted value
  • Fixed symlinked app discovery
  • Modifier-mode leader cheatsheet preview added

0.58

  • Text mode and search mode shortcuts refined
  • Filesystem watcher rescans less disruptive
  • Action pane selection and backspace fixed
  • Shelf interaction simplified
  • Fixed current selection staging

0.57

  • Fixed keyboard layout handling in Fuzzy mode
  • Fixed copy/paste/etc in settings window

0.56

  • Add note about "fake" pro period ending
  • Fix plain text pastes getting rich text formatting
  • Load contact thumbnails lazily for better performance
  • Fix memory use in preview cache and watcher event buffering

0.55

  • Faster settings pane and library browsing

0.54

  • Fix image copy

0.53

  • Add phone call action
  • Submit Talk Mode recording with Enter
  • Search subject substrings with new toggle
  • Cmd-G grabs current selection in fuzzy mode
  • Tab now works in leader mode
  • Window management cycling and gap settings
  • Open settings panes directly from commands
  • Clipboard history previews improved
  • Clipboard history migrated to SQLite (faster)
  • Fix recursive paste crash
  • Fix currency conversion rates fallback
  • Caps Lock Hyper more reliable on all systems
  • Localized app name search restored

0.52

  • Keep make default scoped to typed queries
  • Tighten default theme window padding
  • Preserve clipboard images and rich text
  • Reduce app scan and action hangs
  • Reduce pasteboard hot-path hangs
  • Fix Obsidian note actions and sorting
  • Refactor target action policy
  • Support symlinked config files
  • Update Uninstall review tree
  • Add folder browse support to leader mode builder
  • Seed Finder Rename target with current name
  • Use typed query in default menu labels
  • Fix command menu shortcuts

0.51

  • Upgrade currency API (more currencies)
  • Add "Send to Script ..." action
  • Add double-press activation trigger
  • Add device eject action
  • Add result menu disable action
  • Add custom leader mode icons
  • Rich metadata for script commands
  • Fix Quick Look monitor placement
  • Fix directory browse sorting
  • Reduce app hangs

0.50

(Nothing too fancy here. Mostly just a maintenance release)

  • Fix commit style for runnable hints
  • Rebuild Library details pane list
  • Run system tasks in background

0.49

  • New "Send Global Keys" action added
  • Fixed single-modifier hold triggers
  • URL opens no longer block the main thread
  • Talk Mode shows output mode ( toggles while recording)

0.48

  • Fix visual glitch when opening in Leader Mode
  • Fix update window display in accessory mode crash
  • Add error reporting (opt-out available)

0.47

  • Open app approach reverted
  • Script directories gated behind Pro
  • Cross-mode Tuna activations added
  • Library pane item loading improved
  • File URL drag-and-drop restored
  • Dedicated mode switch action added

0.46

  • Add Messages actions extension
  • Fix Finder activation across Spaces
  • Add current clipboard item to meta
  • Clarify dictation trigger wording

0.45

  • Built-in Hyper key support
  • New Settings catalog for Tuna preferences
  • Add alternating caps text action
  • Add setting to always show results in Fuzzy
  • Add duration conversions to Text Mode
  • Shelf color previews
  • Stack multiple Confetti bursts
  • Warn before quitting on config conflicts
  • Fix modifier mode tracking and add left-side options
  • Fix emoji skin tone settings and browse sort
  • Fix library detail refresh after enabling source
  • Keypad Enter now confirms commits
  • Restore Finder to System Apps

0.44

  • Fixed extension store signature verification

0.43

NB: This release resets your aliases and mnemonics. Sorry about that.

  • Add clipboard color previews
  • Add keyboard send actions
  • Add uninstall app flow
  • Add weird effects command catalog
  • Aliases now bind to exact items
  • Leader app stays on its current display
  • Recognize bare domains as URLs
  • Split Cmd-K command menu from item row menus
  • UI is again constrained to theme size

0.42

  • Fix emoji grid result display
  • Fix file drags from search results
  • Add Forget action for clipboard history
  • Add Current Finder Location item
  • Improve Leader editor interactions

0.41

  • Fix text-item backspace clearing
  • Fix results row drag hit area
  • Add leader mode backspace behavior setting
  • Add configurable script directories
  • Hide history items from global search
  • Add alias management to learning settings

0.40

  • Hotkey commands are now editable
  • Faster emoji browsing
  • Clipboard history starts immediately on launch
  • Clipboard history uses date-based retention windows
  • Color values use basic copy action
  • New email actions extension
  • New compress actions extension
  • Dictation stays open if you switch apps while recording

0.39

  • Fix leading space when switching to text mode
  • Clear staged entries when switching modes
  • Add active-app menu items to catalog
  • Add UTF glyphs to emoji picker
  • Fix external display window commands
  • Fix empty Finder selection crash
  • Handle command-backspace in fuzzy mode with delete-by-char
  • Add Define action for Dictionary lookups
  • Add configurable result navigation bindings (vim/emacs nav keys)
  • Unify browse sorting and sort indicator

0.38

  • Faster clipboard history selection for large text
  • Search scope resets when reactivating the app

0.37

  • New Text File action available for folders
  • Open With support for files and folders
  • Text case actions added
  • Fuzzy Run action for leader groups
  • Duplicate hotkey warnings shown in settings
  • Clipboard paste defaults and large-payload performance improved
  • Smart folders added
  • App-name fuzzy search improved
  • Clipboard sort order setting removed
  • Pro licensing always-on with grace period toggle

0.36

  • Faster fuzzy-search UI rendering
  • Fix Spotlight search hangs
  • Fix Safari Current Page token resolution
  • Fix hotkey text-target staging
  • Shelf auto-close setting added
  • No-results text mode fallback setting
  • Configurable fuzzy spacebar behavior
  • Extensions auto-activate on install
  • Command picker sizing improved
  • Removed unused center window action

0.35

  • Add inline search via Spotlight
  • Fix window top/bottom commands being swapped
  • Reduce false beeps on window actions
  • Fix All Windows activate action routing
  • Fix leader mode keyboard layout and duplicate crash
  • Add sleep displays system task
  • Custom folder scan limits and filtering guardrails

0.34

  • More currencies supported for exchange rates
  • Leader Actions catalog added
  • Search results render faster with less churn
  • Fixed crash with Unicode characters in search
  • Fixed onboarding not resuming after relaunch
  • Fixed settings editing stability
  • Added legal pages

0.33

  • Added global shelf and onboarding command actions
  • Expanded Stage input support in Tuna service
  • Fixed text mode navigation and editor interactions
  • Fixed and refined leader mode command visibility
  • Hardened leader mode config migration decoding
  • Fixed emoji hotkey loading state
  • Fixed whisper model sync in dictation settings
  • Prevented dictation recording after UI dismissed
  • Improved window sizing, positioning, and theme bounds
  • Improved startup and search performance throughout

0.32

  • New color items and tools
  • Hide-all windows command added
  • Fixed window maximize and display cycling
  • Fixed sort order in date-sorted browsing
  • Results enter animation restored in default and Normie Bar themes
  • Delete Whisper models from the picker

0.31

  • More reliable current text selection detection

0.30

  • Whisper idle model offload setting added
  • Dictation history persisted across sessions
  • Improved dictation media resume after interruption
  • Refined dictation search UX and previews
  • All Windows catalog and search entry added
  • Library catalog organization and search defaults improved
  • Leader-mode theme styles and overlay added
  • Command history gains resolve action
  • Current selection exposed as meta items
  • Clipboard history skips unrecognized entries
  • Smart link icon quality improved
  • Tuna URL execution gated behind a setting

0.29

  • Status bar icon highlights when Tuna is active
  • Parakeet dictation engine for Apple Silicon
  • Normie Bar theme
  • Sparkle update indicator
  • Fix IME handling in text mode

0.28

  • Icon preview rendering now stable and properly cached
  • Shelf ignores drops onto itself
  • Drop bundles support target-aware staging
  • Free tier clipboard text size cap removed
  • Pro limits enforced at runtime and config import
  • Premium dictation models gated by Pro status
  • Pro mode capability gates and setup added

0.27

  • Split application catalogs by scope and depth
  • Solidify calculator parser and evaluator architecture
  • Add algebra examples and timezone evaluation
  • Add in-window command mode switching
  • Fix run URL action resolution fallback
  • Stage leader groups into Leader mode
  • Refactor large type preview and screen fitting
  • Refactor GitHub extension catalogs and repo resources

0.26

  • Safari drag and drop now works in shelf
  • Folder creation enabled in config folder picker
  • Dictation media pause/resume more reliable
  • Extension development workflow finalized
  • GitHub extension support added
  • System and Xcode apps now searchable
  • Leader Mode symbol picker restored
  • Version shown in status menu

0.25

  • Cap results header query to one line
  • Trigger Library scan after extension installs
  • Add Spotlight search action for text items
  • Add light/dark mode system task
  • Refine dictation live transcript flow and UI feedback

0.24

  • Fix extension store icon fallback and compatibility checks
  • Restore wake prewarm for faster post-sleep activation
  • Fix release notes bullet parsing
  • Fix extension upload target resolution

0.23

  • Fixed text editing shortcuts in Leader Mode URL builder
  • Fixed paste behavior routing in main launcher window
  • Simplified extension media upload and storage handling
  • Fixed extension install errors for signed frameworks

0.22

  • Maintenance release

0.21

  • Maintenance release

0.20

  • Maintenance release

0.19

  • Maintenance release

0.18

  • Maintenance release

0.17

  • Maintenance release

0.15

  • Maintenance release

0.14

  • Maintenance release

0.12

  • Maintenance release

0.11

  • Maintenance release

0.7

No release notes.

0.6

Go ahead, brave one.