Hafþi for Mac

A native macOS version of Hafþi for Linux, written in Swift and AppKit. SwiftTerm handles terminal emulation; Metal rendering is used when available, with a Core Graphics fallback.

Download

Download Hafþi 0.1.0 beta 3 for Apple Silicon. Unzip Hafthi-0.1.0-beta.3-macOS-arm64.zip and drag Hafþi.app to Applications. It requires macOS 13 or later. You do not need Xcode or build tools to run the download.

The beta is ad hoc signed, but not notarized with an Apple Developer ID. If macOS blocks the first launch, try opening the app, then choose System Settings → Privacy & Security → Open Anyway for Hafþi. You do not need to disable Gatekeeper for the whole Mac.

Features

Shortcuts

The right-click menu also offers Reset Font Size, Clear Scrollback and Edit Hafþi Config. Closing the last window quits the app.

Optional Fish and Starship

Install Fish separately with brew install fish to make it Hafþi's preferred shell. Without Fish, Hafþi opens your normal login shell. To show Fish's welcome message in new windows, turn it on in Preferences. Hiding the message affects only Fish sessions launched by Hafþi; it does not edit your Fish configuration.

Install Starship separately with brew install starship. When Fish and Starship are both installed, new Fish windows use Starship by default. Preferences has a switch for Hafþi's automatic Starship initialization. If your config.fish already initializes Starship, Hafþi leaves that setup in place. The switch applies to new windows and does not change config.fish. With another login shell, follow Starship's shell setup guide instead. Neither Fish nor Starship is bundled in the app.

Optional command help

Enable Command help in Preferences. Install tgpt separately with brew install tgpt, or click Install tgpt… to place that command at the terminal prompt and press Enter yourself. Type a macOS terminal question in Preferences and click Ask tgpt, or open the question field from the right-click menu. The answer appears in the terminal. Questions are sent to tgpt's online provider; Hafþi does not automatically run suggested commands.

Preferences and configuration

Use ⌘ , for font, colors, opacity, padding, scrollback, image/GIF mode, Fish greeting, Starship and command help. Preferences are saved in ~/Library/Application Support/Hafthi/config.json. You can open that file from Edit Hafþi Config in the right-click menu. Changes to the Fish greeting and automatic Starship startup take effect in new windows.

Build from source

You need macOS 13 or later, an Apple Silicon Mac and Xcode Command Line Tools (xcode-select --install).

git clone https://github.com/pdahlbeck/hafthi-mac.git
cd hafthi-mac
swift run --build-system native HafthiMac

To create a standalone app bundle locally:

bash build-app.sh
open build/Hafþi.app

Port status

This is a macOS beta. The Linux version uses a custom wgpu preferences interface and Wayland-specific transparency. The Mac app uses native AppKit preferences, macOS transparency and optional Metal rendering. Linux features still in development, such as split panes and Open File Manager Here, are not advertised as Mac features.

License

Hafþi is MIT licensed. SwiftTerm is also MIT licensed; see its license. Starship is installed by the user and is not included in Hafþi; it is ISC licensed.