Skip to content

Honu 0.2

Pre-release
Pre-release

Choose a tag to compare

@ctchuang ctchuang released this 22 Oct 18:43
· 41 commits to main since this release

Honu now lives on every desktop and stays out of the way of your other apps until you turn to it.

What's new

  • On every desktop. Honu follows you to every desktop (Space). To keep it on just one, right-click the turtle and turn off Show on All Desktops; the choice is saved.
  • Behind your apps until you use it. While another app is in use, Honu sits behind its windows, showing only where the desktop shows, and never takes that app's clicks or keys. Click a bubble or the turtle where it shows, or switch to Honu with the Dock or ⌘Tab, and it comes to the front; that first click acts at once, so you can drag a bubble or open the launcher straight away. Turning to another app sends Honu back.
  • Mission Control works again. Mission Control and App Exposé lay out your other windows instead of a window the size of the screen, and the Space thumbnails show their windows while Honu is in the back.
  • No full screen. Honu's window never goes full screen, even with Fn-F or ⌃⌘F.
  • The UI's design is written down in docs/UI.md, and the README is shorter.

Known issue

If Mission Control opens while Honu is the active app (right after clicking a bubble or the turtle), its Space thumbnails show only the wallpaper. Click another app first and they are fine. See #5.

Running it

There is no prebuilt app yet: build it from source. It needs macOS 26 or newer and a Swift 6.2 toolchain (the Command Line Tools are enough).

git clone https://github.com/ctchuang/honu.git
cd honu
git checkout v0.2
swift run

Making microapps needs Claude Code, signed in with your Claude account (run claude once in Terminal); Honu uses no API key.

Status: experimental prototype. Expect breaking changes.

Full changelog: v0.1...v0.2