Changelog

Every release of Floe.

What changed in each release, newest first. The newest three have their notes written out. A line of an older one opens its notes under it.

Follow in a feed reader
0.1.0macOS 26 and laterBuild 1Stable

Floe is a launcher for macOS. It runs Raycast extensions unmodified and opens things in the apps you already use. This is the first release, and it is early.

After you install:

  1. Press ⌃⌥Space to open the search. Settings > General changes the hotkey.
  2. Open the Extension Store from the search to install extensions.
  3. Look at Settings > Privacy. Files, browser tabs, Shortcuts, Fast file search and currency rates are off until you turn them on.
  4. If something looks wrong, open an issue.

New

  • One hotkey opens the search. It finds applications, extension commands, script commands, quicklinks and System Settings panes, and ranks them by how often and how recently you use each. Web apps a browser installed are found too. Two apps with the same name each get their own row. Scattered letters match, and the ones that matched show in a stronger weight.
  • Aliases, hotkeys and favorites. Give an application or a command an alias or a hotkey. Emoji, Clipboard History, File Search and the system commands take a hotkey too, in Settings > General. Favorites stay at the top.
  • Scopes narrow a search to one place: files invoice, menu wifi, tabs invoice.
  • A web address or a path typed in full leads the results. github.com/thaw-app opens in the browser. ~/Downloads is the folder itself, with the file actions.
  • keywords or ? lists every word the search answers to, each with an example and what it does: remind call mom tomorrow at 5pm, timer 10 minutes tea. Type more to narrow the list. Return puts the keyword in the search for you to finish. What is switched off is left out.

Results and actions

  • An Actions menu (⌘K) on applications and files: hide, quit, restart, force quit, show in Finder, open with, copy, move to Trash.
  • Hide from Search takes an application or a command out of the search. Settings > General lists what is hidden and brings it back.
  • The Up arrow brings back earlier searches: the last 50 that opened something. Settings > Privacy turns this off and forgets them.
  • Optional search sources. Files and open browser tabs (Safari, Dia, Helium) add up to three rows to a search. Both are off until you turn them on in Privacy.
  • Floe --pick lends the search panel to a script. It reads lines on standard input and prints the one you choose.

Shell commands

  • Type > and a command to run it. Return runs it in the background and shows the first line of output. Your shell aliases work. Settings > General changes the prefix to $ or !, or turns this off.
  • Other ways to run it. ⌘Return opens it in your terminal, ⌥Return shows everything it printed, and ⇧Return runs it in the Finder folder in front.
  • Suggestions while you type: earlier commands from your shell history, programs, paths, application names after open -a and hosts after ssh. Tab finishes the selected one.
  • A command works without the prefix when it starts with a program on your Mac and has a flag, a path or a pipe in it. It is offered under the other results.
  • Save a command under a name and the search finds it afterwards. man and a program's name opens its manual.
  • Script commands. Scripts written for Raycast, put in Floe's Scripts folder, are in the search and take up to three arguments.

Checkpoints

  • pause and a name saves what you were doing: the files and folders selected in Finder, the tabs of the browser window in front, and a note after a colon. pause website redesign: fix the nav next.
  • Search for the name to resume it. Text and code files open in the editor you chose in Settings, other files in their own apps, folders in Finder and the tabs in your browser. Floe shows your note.
  • Floe says what is missing when a file has moved or gone, and lists it. What is still there opens.
  • Pausing again under the same name replaces the checkpoint with what is open now.

Receipts

  • Floe keeps a receipt of what it changed: commands it ran, files it moved to the Trash, processes it quit and extensions it removed. Type receipts to see them.
  • Return puts a file back from the Trash to where it was. If something newer is there now, Floe leaves both alone and says so.
  • A command or a quit process cannot be undone, and the receipt says that. Settings > Privacy turns receipts off and forgets them.
  • Notes and checkpoints leave receipts too. A note written to your folder goes to the Trash from its receipt if you have not changed it, and a checkpoint's receipt deletes it. A line added to the day's note cannot be undone.

Reminders and events

  • remind and a sentence adds a reminder to Apple Reminders. remind call mom tomorrow at 5pm is due tomorrow at five, and the row shows the date before you press Return. Without a date in it, the reminder has none.
  • Its receipt deletes it again. macOS asks once whether Floe may use Reminders.
  • End the sentence with a list's name to put it there. remind call mom tomorrow at 5pm in Work, or list Work. The row shows the list.
  • event and a sentence adds an event to Apple Calendar. event lunch with Ana Thursday noon lasts an hour from Thursday at twelve, and a day with no time makes an all-day event. Its receipt deletes it again.

Timers, people and controls

  • timer 10 minutes starts a countdown. timer 25m, timer 1h 30m and timer 5 min tea work too, and a notification with a sound says when it ends. timers lists the ones running, and Return stops one. Timers end when Floe quits.
  • contact ana finds people in your Contacts by name, with a phone number or an email address beside each. Return opens the card, and the Actions menu calls, starts FaceTime, writes a message or an email, or copies the number or the address. macOS asks once whether Floe may read Contacts.
  • mail and message open a draft. mail toni@example.com the build is ready opens a new email to Toni in your mail app, and message +15551234567 running late a new message in Messages. Without an address or a number first, the draft has no recipient. Nothing is sent until you send it.
  • Play/Pause, Next Track, Previous Track and Now Playing control Spotify or Music, whichever is open. Search for pause, skip, previous or what's playing. Now Playing shows the track and its artist. macOS asks once whether Floe may control the app.
  • Toggle Focus, focus 1 hour and focus off run a Shortcut you name in Settings > General. macOS gives apps no switch for Focus, so the Shortcut sets it: Floe hands it the minutes, or the word off or toggle. Until you name one, the row says so and Return opens Shortcuts.

Processes and ports

  • kill and a name lists the running processes that match, with the memory each one holds. Return asks one to quit. Force Quit asks first.
  • port and a number lists what is listening there.

Extensions

  • Raycast extensions run unmodified inside the app, including the ones Raycast already installed.
  • An Extension Store page browses, installs and updates extensions. By @OwenCope in #6.
  • Lists, details, forms, preferences, arguments, toasts, confirmation dialogs, and background and interval commands work. Passwords go in the Keychain.
  • You add menu bar commands by hand, from the search or from Settings. None starts on its own at launch.
  • When a command throws, crashes or hangs, Floe shows the log and lets you run it again.
  • An extension that holds more than 1 GB of memory is stopped. Floe says so, and how much it held.
  • An extension you are writing runs again when you save it. While one of its commands is open, a save under src or assets, or of package.json, runs the command again with the same arguments.

Extension settings and sign-in

  • Turn off an extension, or one of its commands, on its page in Settings. Floe leaves what is off out of the search, and a hotkey, the menu bar or Shortcuts will not run it.
  • Each extension's page has one line per command, with its alias, hotkey and switch. You can give the extension an icon of your own, or remove an extension Floe installed.
  • Each extension's page shows what it has reached: the hosts it contacted, the folders it read and changed, and the programs it started, as far as Floe's runtime sees them. It records what the extension did and stops none of it. Settings > Privacy switches the record off and forgets it.
  • GitHub and GitLab extensions sign in with the GitHub CLI and the GitLab CLI. If gh or glab is signed in on your Mac, Floe asks once per extension whether it may use that sign-in. For GitHub it lists what the sign-in may do. The extension's page in Settings takes it back.
  • Other extensions sign in in the browser. Where the browser's answer cannot reach Floe, Floe asks for the token the extension takes and runs the command again. Known issues says whose service the sign-in uses for now.

Built in

  • Snippets with text expansion, and quicklinks with fallback searches. By @OwenCope in #6.
  • A calculator with unit conversion. It converts money with the European Central Bank's daily rates once you turn that on in Settings > Privacy, and shows the day the rates are from. Powers are drawn as real superscripts, and pi is π. By @lylythechosenone in #7.
  • The calculator reads sums the way people type them. 200 + 10% is 220, 100 f to c converts a temperature, 5 ft 10 in to cm is 177.8 cm and today + 3 days is a date.
  • define tide shows what the dictionary says about a word. The answer comes from the dictionaries on your Mac, the ones switched on in the Dictionary app, so nothing is sent anywhere. Return opens the word in Dictionary, and the Actions menu copies the definition.
  • Emoji and symbols. Hands and people use the skin tone you choose in Settings > General. By @OwenCope in #6.
  • File search, calendar events and menu bar item search. Menu bar search lists the menu bar's items and opens their menus from the keyboard. File search asks Spotlight. Switch on Fast file search in Settings > Privacy and Floe keeps the names of the files in your home folder, in memory and in a file on this Mac, and answers from those: scattered letters match, at each key, and files you opened lately come first. Later launches read the file and only what changed since; switching it off deletes the file. macOS then asks whether Floe may read your Desktop, Documents and Downloads folders. By @OwenCope in #6.
  • System commands: sleep, lock, empty Trash, volume up and down, eject all disks, and toggles for Wi-Fi, Bluetooth, mute and keeping the Mac awake. System Settings panes open from the search too. By @OwenCope in #6.

Your own apps

  • Preferred apps: a terminal, an editor, a browser and a notes app. Files, folders and the Finder selection open in them, and web links open in the browser you choose. The editor can be one that runs in your terminal: Helix, Neovim, Vim, Emacs and others on your Mac are offered by name. Open With sends one link to another browser.
  • A preferred clipboard app. Choose a clipboard manager and Clipboard History opens it. Floe keeps no clipboard history of its own.
  • SSH hosts. The hosts in ~/.ssh/config are in the search, and ssh and a space lists them. Return connects in your terminal. Floe reads the names and keeps nothing.
  • Apple Shortcuts, once turned on in Settings > Privacy. Return runs one in the background. If it fails, Floe shows the reason Shortcuts gave.

Notes

  • note and some text goes to Apple Notes, Antinote, any app with a URL scheme, or a folder of Markdown files, which is what Obsidian and Octarine read. With a folder, append adds a line to the day's note.
  • In an Obsidian vault, the day's note is the one Obsidian opens. Floe follows the folder and the date format set under Daily notes, such as YYYY/MM/DD or dddd, MMMM Do YYYY, with English month and day names. A format it cannot read falls back to YYYY-MM-DD.
  • todo and log write to the day's note. todo renew passport adds a checkbox, - [ ] renew passport, and log shipped the build adds the line with the time in front, - 14:05 shipped the build. append alone opens the day's note.

AI

  • Ask AI. Type ask and a question, or pick the Ask AI row under any search. The answer shows in the launcher, with who answered and whether it stayed on your Mac.
  • Follow-up questions keep the earlier ones as context. The conversation ends when the view closes, and no history is kept.
  • Three kinds of source: a command line tool you are already signed in to (claude, codex, opencode or pi), Apple Intelligence, or an OpenAI-compatible API (OpenAI, OpenRouter, Z.ai, Ollama, LM Studio).
  • A switch keeps all AI on your Mac. One extension can have a source of its own. No source falls back to another.

With Thaw

  • Thaw 3's actions are in the search when Thaw is installed: the hidden sections, swap, Zen Mode, the Thaw Bar, the layout and the application menus.
  • The launcher can follow Thaw's menu bar appearance: its tint, glass, border and shadow.

Appearance and settings

  • Thaw 3's glass styles, a tint, a border and a shadow for the launcher, with a preview that changes as you choose.
  • A compact layout shows only the search bar until you type.
  • The search field is rounded, a capsule or square. It can also float as its own piece of glass, with the results in a second piece below it.
  • A Privacy page lists the permissions and their reasons, the search sources, and everything Floe contacts over the network.
  • A welcome at first launch asks for Accessibility, which the launcher needs, and offers Calendar, Reminders and Contacts, which you can leave for later. A short tour follows. If a later version needs a permission you have not answered, that step comes back by itself.
  • Search the settings from the toolbar of the Settings window.
  • Export your settings to one file and import them on another Mac.
  • Launch at login, and updates. Floe asks once whether it may check for updates, and whether to install them by itself. Settings chooses between the Stable and the Beta channel.
  • What's New and detailed logging. What's New, in About, shows these notes in the app. Detailed logging is off by default and writes to ~/Library/Logs/Floe. It never logs what you type or ask.

Shortcuts and Siri

  • Three actions in Apple's Shortcuts app: Open Floe, Run Command and Search Menu Bar Items. Siri runs them too.

Sync

  • Settings sync with iCloud, off until you switch it on in Settings > General. Aliases, hotkeys, favorites, hidden results, appearance, snippets, quicklinks and extension settings are the same on your Macs, and the newest change wins.
  • Passwords through iCloud Keychain, a second switch that is off until you choose it. Extension passwords and API keys become iCloud Keychain items; off copies them back to this Mac and leaves them in iCloud Keychain.
  • Some things stay on each Mac: folders, permissions, AI settings, an extension's files, folders and chosen apps, sign-ins and receipts. Remove Settings from iCloud deletes iCloud's copy and switches sync off on every Mac.

Known issues

  • Extension sign-in goes through Raycast's sign-in service for now. Floe has none of its own yet: the browser returns through raycast.com, and some extensions get their token from Raycast's servers. Floe says so before the first sign-in. This is temporary and may stop working, and Floe's own sign-in service is planned to replace it. GitHub and GitLab use their command line tools first, and an extension whose sign-in cannot be received is asked for its token.
  • launchCommand, deeplinks, AI tools and the grid layout for extensions are not built yet.
  • The record of what an extension reaches misses some file access. It sees hosts and programs more reliably than files.
  • Timers end when Floe quits. They are held in memory.
  • Fast file search leaves out iCloud Drive, which macOS keeps inside Library.
  • Floe is in English only. Its text can be translated on Crowdin.

Contributors

  • @OwenCope wrote the Extension Store page, snippets, quicklinks, emoji, file search, calendar events, menu bar item search and the system commands (#6).
  • @lylythechosenone wrote the calculator (#7) and its superscripts, tested Floe and suggested features.
  • HiroMike on Discord tested Floe and sent feedback.
  • dor4a on Discord tested Floe and asked whether commands could have a key of their own, such as ⌘E for emoji or ⇧⌘V for the clipboard. Emoji, Clipboard History, File Search and the system commands take a hotkey now.
  • @unsecretised reported the first bugs, in the Settings window (#3).

Acknowledgements

  • fend by printfn is the calculator's engine. Exchange rates are the European Central Bank's euro foreign exchange reference rates.
  • Code from Droppy Code by Jordy Spruit is used with his permission.
  • Extensions are written for the Raycast extensions API. Raycast is a trademark of Raycast Technologies Inc.; Floe is not affiliated with Raycast.
  • Credits lists every package Floe ships with.