Repository navigation
Releases
v0.6.2
Helge Terminal 0.6.2
Links
- Hold Command over a link to see its destination before opening it.
- Keep the destination visible while hovering, including during cursor refreshes.
Images
- Correct Kitty animation frame composition.
- Support Kitty animation frame deletion and correct frame timing after edits.
- Position and delete relative Kitty images correctly, including Unicode placeholder parents.
- Report supported Kitty graphics features accurately for each action.
- Display images from current Kitty clients using larger chunks and unpadded base64.
- Bound SIXEL command state when processing image data.
Crash recovery
- Restore windows, tabs, splits and scrollback text after a crash or forced quit.
- Offer to resume an interrupted agent session; nothing restarts until you choose Resume.
Search
- Add case-sensitive, whole-word and regular-expression search options.
- Support groups, alternation, classes,
{n,m}repetition and\d,\s,\win regular expressions, with bounded work. - Scroll to the matched text instead of a neighboring row.
Shell integration
- Add Bash and fish integration alongside zsh.
- Jump between commands in scrollback, including after the window width changes.
Settings
- Add launch profiles, remappable menu shortcuts and theme colors through an importable JSON configuration.
- Choose separate behavior for the left and right Option keys.
- Choose the cursor shape and blinking, or follow the application's requests.
- Add a visual bell that briefly outlines the pane.
Text and rendering
- Draw curly, dotted, dashed and double underlines, and underline colors.
- Show blinking text when a program requests it.
- Scroll smoothly by fractions of a line.
- Fix stale frames after a resize.
Keyboard and mouse
- Support xterm modifyOtherKeys and formatOtherKeys keyboard reporting.
- Support pixel-precise (SGR-Pixels) mouse reporting.
Images and downloads
- Honor stretch and aspect-ratio requests for iTerm2 inline images, and play animated GIFs.
- Offer a file sent by a terminal program as a download: nothing is written until you choose Save and a destination. Several files queue in the pane.
- Keep images in place when text scrolls inside margins.
Terminal compatibility
- Answer more status queries: DECRQSS settings, DECDSR device reports, DECID and DECRQM for additional modes.
- Add reverse-wrap modes 45 and 1045.
- Fix cursor, erase, rectangle and saved-cursor behavior found by the esctest conformance suite, which now passes 460 of 567 cases.
- Never report a window or icon title back to a program, so output cannot place text on the command line.
- Report the terminal's own name and version through XTVERSION.
Automation
- Add read-only AppleScript collections for windows, tabs and panes.
- Add AppleScript commands to read pane history, working directory, selection and saved preferences, and to apply a desktop configuration.
Release builds
- Exclude developer diagnostic launch modes from distributed apps.
- Run tests separately from signing and notarization.
v0.6.1
Helge Terminal 0.6.1
Integrations
- Register Helge Terminal as a macOS terminal application so tools such as JetBrains Toolbox can discover it.
- Open executable command files in new terminal windows, including when the app is already running.
Images and updates
- Improve Kitty graphics compatibility with animations, relative image placements, and Unicode placeholders.
- Show version-specific release notes inside the update dialog.
Embedding
- Add terminal views for SwiftUI and iOS.
v0.6.0
This release runs on Intel Macs and on macOS 14.
- The app is now a universal build: Apple silicon and Intel. On Intel the
terminal used to stop while starting its renderer. - The oldest supported system is macOS 14 instead of macOS 15.
- Double-clicking to select a word no longer fails with a limit error when
several word selections follow each other while the Mac is busy.
For developers who embed the terminal:
- A session starts its child process itself. A host no longer has to
build, bundle and sign theTerminalLauncherhelper. - The Swift package's minimum is macOS 14, on both architectures.
Installed copies of 0.4.0 or later offer this update at launch or from
Check for Updates… in the app menu.
Download the signed, notarized universal app ZIP below.
Requires macOS 14 or later.
v0.5.1
This release is for developers who embed the terminal in their own app.
The app itself behaves as in 0.5.0.
- The terminal view now starts on Intel Macs. It used to stop while creating
its first glyph page, because Metal on a Mac whose GPU has its own memory
refuses the kind of texture storage the view asked for. - The Swift package's minimum is macOS 14 instead of macOS 15.
The app is still built for Apple silicon and macOS 15 or later.
Installed copies of 0.4.0 or later offer this update at launch or from
Check for Updates… in the app menu.
Download the signed, notarized Apple Silicon app ZIP below.
Requires macOS 15 or later.
v0.5.0
This release adds a font menu, ligatures and a setting for how emoji
sequences are laid out.
- Settings > Text has a font menu. Obel Mono is still the default. JetBrains
Mono, Fira Code, Hack and IBM Plex Mono now come with the app, and the
fixed-pitch fonts installed on your Mac are listed under them. Icons are
drawn from the bundled symbols font whichever font you choose. - "Join ligatures" draws
->,!=,===and the like joined in fonts that
have ligatures, such as JetBrains Mono and Fira Code. It is off until you
turn it on. - "Join emoji sequences" is on, as before. Turn it off if zsh overwrites its
prompt while you edit a command line that holds an emoji with a skin tone,
a flag or a joined emoji: each part then takes its own cells, as zsh counts
them, and such emoji are drawn in parts. Programs can also switch this
themselves with mode 2027. - A bell from a program no longer disappears inside the emulator; the app
itself still makes no sound.
For developers: the terminal is now a Swift package that other macOS apps
can embed, with a view, a session that runs a process or a custom transport,
and a headless emulator. See docs/embedding.md. The interface is new and
may change before 1.0.
Installed copies of 0.4.0 or later offer this update at launch or from
Check for Updates… in the app menu.
Download the signed, notarized Apple Silicon app ZIP below.
Requires macOS 15 or later.
v0.4.3
This release makes trackpad scrolling follow your fingers.
- A trackpad scrolls one line for each line height of finger travel, and
movement adds up across events. Each small trackpad movement used to be
divided by a fixed amount and the rest thrown away, so a slow swipe did
not scroll at all and a fast one jumped. - Programs that read the mouse, such as Claude Code, Vim and less, get one
scroll step per line instead of one for every trackpad event, however
small. An event with no vertical movement no longer scrolls down. - Changing direction or starting a new swipe starts afresh. A mouse wheel
still scrolls at least one line for each notch.
Installed copies of 0.4.0 or later offer this update at launch or from
Check for Updates… in the app menu.
Download the signed, notarized Apple Silicon app ZIP below.
Requires macOS 15 or later.
v0.4.2
This release stops asking before programs write the clipboard, and makes
Shift-Enter reach Claude Code and other programs that use the kitty keyboard
protocol.
- Programs that copy through OSC 52, such as Claude Code, tmux and Neovim,
write the clipboard without an Allow / Deny prompt. The prompt used to
appear in every tab and pane and again for every copy, and a second copy
within a second of a prompt was dropped without a word. Size limits stay,
and programs still cannot read the clipboard. - Shift-Enter, Shift-Tab and Shift-Backspace are reported with their
modifier to programs that turn on the kitty keyboard protocol, as in kitty
and Ghostty. Shift-Enter used to arrive as a plain Return, so Claude Code
submitted the prompt instead of starting a new line. Enter, Tab and
Backspace without Shift, and every key in programs that do not use the
protocol, send the same bytes as before.
Installed copies of 0.4.0 or later offer this update at launch or from
Check for Updates… in the app menu.
Download the signed, notarized Apple Silicon app ZIP below.
Requires macOS 15 or later.
v0.4.1
This release makes the pane color popover, Settings and the Edit menu work
from the keyboard, and draws output with less processor time.
- Right-clicking a pane header opens the color popover where you clicked.
Shell > Pane Color… opens it from the keyboard, also when the header is
hidden. Arrow keys, Home and End move through the colors and preview them,
Return or Space keeps one, and Escape puts back the color the pane had.
Tab and Shift-Tab move between the colors and the hex field. - VoiceOver reads the colors as a group of radio buttons, and the pane
header offers Choose Pane Color and Close Pane as actions. - AppleScript can read and change a pane's color with
read pane colorand
apply pane color, which takes a hex value, a palette name ordefault.
configure preferencestakes adefault pane color. - Tab and Shift-Tab move through every field, checkbox and button in
Settings, whatever the system's Keyboard Navigation setting. Space toggles
a checkbox, Left and Right change the pane dimming level, and Up and Down
change the section. VoiceOver reads each field's hint. - The Edit menu has Undo, Redo, Cut and Delete for the find bar, Settings and
the hex field. In the terminal, ⌘Z, ⇧⌘Z and ⌘X still go to the running
program, and Copy is available only when text is selected. - The PTY is read in 64 KiB slabs instead of 16, which raises foreground
throughput by 12% on short ASCII lines, 11% on long ones, 4% on truecolor
and 5% on mixed Unicode. A key typed during a flood can wait behind up to
128 KiB of output instead of 64 KiB; its slowest arrival rose from 0.40 to
0.67 ms. - Each frame is drawn from one reused buffer, so drawing uses 7% to 28%
less processor time per MiB of output. These are measurements on one Mac;
see the
method and results.
Installed copies of 0.4.0 offer this update at launch or from Check for
Updates… in the app menu.
Download the signed, notarized Apple Silicon app ZIP below.
Requires macOS 15 or later.
v0.4.0
This release adds in-app updates, starts split panes at their real size, and
is the first under the MIT License.
- The app updates itself. It looks for a new version once when it starts and
when you choose Check for Updates… in the app menu, and installs one only
after you agree. It never checks on a timer while it runs. Updates are
signed, and come from this repository's releases. Version 0.3.1 has no
updater, so this update still arrives by Homebrew or by download. - A new pane's shell starts on a terminal of the pane's size. It used to
start at 80 by 24 and be resized, which could leave a stray%, a missing
right-hand prompt or a stray character in a new split. - Programs that ask for the microphone, camera, contacts, calendars, location,
photos or control of other apps now get the system's permission prompt,
naming Helge Terminal, instead of being refused. - The menu bar and the About window call the app Helge Terminal.
- The code is released under the MIT License.
- Releases are a signed, notarized ZIP. The PKG installer is gone.
Download the signed, notarized Apple Silicon app ZIP below.
Requires macOS 15 or later.
v0.3.1
This release fixes panes that kept the wrong size after a resize, closes a
pane when its shell is left, and brings control sequence handling closer to
xterm.
- A pane no longer stays at its old size when several panes are resized at
once. Reflowing a resized pane takes memory from one budget for the whole
app; a pane that found it taken used to drop the resize and beep. It now
waits and resizes, and a burst of sizes reflows the text once. - Leaving a shell with
exitor Ctrl-D closes its pane, and the window with
its last pane. A shell that fails as it starts stays open so the error can
be read. - A reopen that arrives while the app is still launching no longer opens a
second window. - Programs are told which terminal they run in, and only that:
TERM_PROGRAM_VERSIONis set, and variables that describe the terminal the
app itself was started from,TERMINFOincluded, are not passed on. - Device control, start-of-string and privacy-message strings are consumed
instead of printed, so sixel data, XTGETTCAP and tmux passthrough no longer
leak onto the screen. CAN, SUB and ESC cancel a control sequence as in
xterm, and the screen alignment test (DECALN) is implemented. - Mode queries report the real state of each mode, the extended cursor
position report keeps its marker, and the device attributes reply no longer
claims sixel support. - Kitty graphics accept padded base64 in a chunk that is not the last, which
is how chafa sends images.
Download the signed, notarized Apple Silicon app ZIP or installer PKG below.
Requires macOS 15 or later.