What’s new in Hun.

New

• With the GitHub CLI signed in, a worktree's branch icon shows its pull request: green for open, violet for merged, yellow while CI runs, red when CI fails.
• Right-click a worktree to delete it. Hun says first whether its PR is merged and what uncommitted changes would be lost, and a merged branch goes with it only if it has nothing the PR doesn't.
• Ask a project's chat to "delete my merged worktrees". It picks them, and Hun deletes them once you confirm. A project's right-click menu can do the same.

Improved

• Clicking an idle worktree no longer moves it to the top of the list.
• Right-click menus for projects and worktrees have icons, the PR's state, and Copy Branch Name and Copy Path.

New

• Git worktrees show up under their project in the sidebar. A worktree without its own .hun.yml runs on the main checkout's, so an agent's worktree runs like the project. Running worktrees stay on top, the rest fold into one line, newest first.
• Point one service at another with ${service.port} in env, such as API_URL: http://localhost:${api.port}. Hun fills in the port that service really runs on, so a worktree's frontend talks to its own backend when Multitask moves it to a free port.

Improved

• Running elsewhere lists any dev server you or an agent started, wherever it runs, and names the worktree it's in.
• A server in an agent's worktree no longer makes its project look like it's running.
• Hover the record in the menu bar for previous and next. Previous goes round from the first piece.
• The running count in the menu bar sits exactly in the middle, and "all quiet" moves up to the corner when music plays.
• Quiet City is out of the music.

Improved

• With Open at login on, Hun starts in the menu bar when you log in, without opening its window. If you hide the Dock icon when windows are closed, there's no Dock icon either. Open Hun from the menu bar or the Dock whenever you need it.
• If Hun needs you at login, for its license or to finish the welcome, it still opens its window.

New

• Music in the menu bar. Press the note in the menu bar's sky and a record turns while eleven calm pieces play, shuffled; hover it to skip one. The music downloads the first time you press play. Don't want the note? Turn it off in Settings › Appearance.
• Open at login, in the new General section of Settings.
• Hide Hun's Dock icon once its windows are closed. Hun keeps running in the menu bar, and the icon comes back when you open the dashboard.
• After an update, Hun shows what's new, like this. It's in Settings › About too.

Improved

• Taking a while? After 15 seconds, the spinner on Run, Restart, Stop or a profile switch shows a small square: click it to force-stop the project, even while Docker isn't responding.
• A service that keeps crashing is restarted after a growing pause, up to 10 seconds, and shows as crashed in between, with a note in its log, instead of flickering back to running every second.
• Activity is the default way the sidebar marks a running project. If you picked one, you keep it.
• Open Hun from the menu bar opens a new window when every window was closed.

Fixes

• Services started while Hun was opened from Finder, Spotlight or at login got macOS's limit of 256 open files, so dev servers watching many folders crashed with EMFILE. They now get the full limit, and Hun explains the error when it does happen.
• hun status no longer says a service that keeps crashing is running.
• A Docker that stops responding no longer leaves Run, Stop and Restart stuck until Hun is restarted.

Improved

• Without an active license, after deactivating a Mac or when a beta key ends, Hun opens the welcome and you unlock it there. The old activation screen is gone.

Fixes

• Unlocking Hun no longer freezes the screen for a moment. The confetti now runs on the graphics chip, and setup work happens in the background.
• The welcome's photos are ready before each step appears, so none shows up late.

New

• A welcome for first launch: unlock Hun, connect your coding agent, add a project and run it, with music you can mute. Replay it any time from Settings › About.
• When you add a project, Claude Code or Codex reads it and writes its .hun.yml for you. No agent installed? Hun works it out from the project's files, as before.
• Ask your agent to change a project's setup from the new Claude or Codex button in the project's header. Every change is checked before Hun uses it, and you can undo it.
• A new menu bar: a photo vista, how many projects are running, and a switch for each project. Pick your vista in Settings › Appearance; light and dark mode each keep their own.
• Choose how running projects show in the sidebar: Bar, Activity or Ring, in Settings › Appearance. A crash shows in red.
• ⌘-click a link in a service's log to open it in your browser.

Improved

• Clay is now the default look, and terracotta is Hun's accent in both palettes and in dark mode.
• New installs start in Multitask, so projects run side by side. The welcome explains the difference, and you can switch any time.
• In the menu bar, a project with one crashed service stays on, shows how many crashed, and can be restarted in one click.
• The menu bar panel opens and closes with a short fade.
• Agent chats start at the top and stay readable as they grow.
• Tooltips are gone; buttons speak for themselves.

Fixes

• The welcome shows again after Hun is deleted and installed again, but not after an update.
• Opening the menu bar panel no longer puts the cursor in a search field.

New

• Settings › Appearance has a Light palette option: Graphite, Hun's original look, or Clay, warm paper and ink with a terracotta accent. Dark mode stays as it is.

Improved

• In light mode, search fields and the selected option in controls like Service/All stand out from the background.
• Opening Hun no longer puts the cursor in the sidebar search. Press ⌘P when you want it.

Fixes

• File pickers and other system controls in Hun use your macOS accent colour instead of green.
• Settings no longer says a key has two activations. It works on up to 3 Macs.

Improved

• Hun adds the hun command to your PATH, so terminals and coding agents can run it right away. A hun you installed yourself is left alone.
• When a service needs Docker, Hun starts Docker in the background instead of bringing it to the front. Docker may still show its dashboard; turn that off in Docker Desktop's settings.

New

• Buy Hun for $9, once: a lifetime license for the complete app on up to 3 Macs, with no subscription.
• When a beta license ends, Hun says so clearly and lets you buy and activate a license right there.

Improved

• Hun checks your license every few hours and when your Mac wakes, not only at launch.
• Activation messages no longer assume a two-Mac limit.

Fixes

• When Docker stops responding, services that run through it show as crashed within about 20 seconds instead of staying "running".
• A service that can't start now says why in its own log.

Improved

• Hun's menu bar icon now stays where you ⌘-drag it, across restarts and updates.
• Choosing a profile for a stopped project just selects it; Run starts it next time. Running projects still switch instantly.
• The Hun skill for coding agents is simpler: it sets up .hun.yml from your project's own commands, helps you create profiles, and always starts services through Hun.

Fixes

• Clicking the menu bar icon again now closes the panel.
• The menu bar panel opens aligned with its icon and shows fresh project status each time.

New

• Profiles: name sets of services in .hun.yml and run one with a click or `hun run <project> -p <profile>`. Switching profiles only starts and stops the difference.
• Hun now sees services started outside it (a terminal, an agent, Docker) and can stop, restart and take them over.
• Edit .hun.yml inside Hun, with highlighting, line numbers and live validation.
• Settings now live in the main window, with a System, Light or Dark theme switcher.
• A redesigned menu bar panel, and a menu bar icon that shows when projects are running.
• Resize the sidebar, and see each project's logo in its header.

Improved

• Busy services no longer slow Hun down: logs stream in batches and render incrementally.
• Project icons stay visible in light and dark mode, whatever their colours.
• Port conflicts name what holds the port and offer to stop it.
• Long project names and narrow windows are handled cleanly.

Fixes

• A service printing a very long line no longer freezes.
• Stopping a project's last service stops the project.
• Run restarts a project whose services crashed.

Fixes

• Preserve live daemon after failed health probe (#3).

Fixes

• Stabilize recovery and mode switching.

New

• Add system light theme.

Fixes

• Trust Dodo for beta expiry.
• Resolve build warnings.

New

• Switch Dodo integration to live mode.

Fixes

• Polish license activation flow.

New

• Updated workflows for Go 1.26.x.

Improvements

• Design branded macOS installer DMG.
• Clarify native macOS positioning.
• Refine macOS download button.

Git workspace

• Review branches, sync state, staged work, local changes, and untracked files without leaving the active project.
• Inspect high-performance syntax-highlighted diffs, switch between staged and unstaged views, and resize the workspace around the task.
• Update branches safely while preserving staged, unstaged, and untracked work, with explicit preflight and recovery states.
• Generate concise commit-message suggestions from the staged diff on supported Macs, then edit before committing.

Integrated terminal

• Open a persistent terminal session for each project directly beneath the workspace.
• Resize the terminal with a native-feeling divider and keep sessions aligned as projects open, close, or change.

Mac distribution

• Ship an Apple-silicon app signed with Developer ID, notarized by Apple, and packaged in a drag-to-Applications DMG.
• Add Sparkle-powered updates with hourly checks, a quiet in-app update banner, release notes, secure archive verification, installation, and relaunch.
• Add Check for Updates to the app menu and connect every release to this versioned changelog.

Runtime

• Keep configured ports when they are free, offset only genuine collisions, and publish the selected launch port as PORT.
• Reconcile listeners only when they belong to the launched service and reject collisions with other Hun services or instances.
• Recover from missing sockets, stale PID files, failed termination, and orphaned development daemons.
• Keep readiness and live-port state aligned with the actual process.

Mac app

• Restore the selected project, open tabs, selected service, and log scope across launches.
• Crossfade project changes with Reduce Motion support and use restrained runtime status treatments.

Runtime

• Prioritize configured ports, verify live listeners, and prevent concurrent port claims.
• Expose daemon health, protocol, PID, uptime, restart controls, and diagnostics in native settings.
• Upgrade the daemon protocol so the app can replace stale background daemons automatically.

Workflow

• Open local running services from the service card or context menu.
• Keep the selected project running when switching from Multitask to Focus whenever possible.

Logs

• Add dual-pane keyboard and mouse routing, live mode, wrapping, deterministic scrolling, and range selection.
• Improve copying with OSC52 and native clipboard fallbacks plus clear visual feedback.
• Reset per-service in-memory logs and distinguish stopping a service from stopping its whole project.

Experience

• Refresh the website and documentation around the project-first workflow.
• Polish hun onboard and validate version output in the Homebrew formula.

Foundation

• Switch between projects in Focus mode or run several side by side in Multitask mode.
• Manage services, automatic port offsets, unified logs, and the terminal UI from one daemon-backed tool.