Main menu

Press Ctrl-G to open the main menu. Most application functions are accessible from here.

Global controls:

• To map a hot key, focus the item then press return to enter capture mode (see Key Bindings)
• To remove a hot key, focus the item then press delete/backspace
• To navigate between pages, press tab

Tip

To send Ctrl-G to the terminal, press it again from the menu. Or remap it if you like.

Functions

The functions tab provides a menu of the main application features and doubles as a key shortcuts mapping interface. Honeymux is not opinionated on which functions deserve hot keys and which don’t — it’s up to you to decide.

To activate a function immediately, press the underlined key shown in the center columns. To enable/disable “hold/release” mode¹ for the zoom functions, use the ⊙ controls.

Note

A single key combination cannot be assigned to more than one function at a time.

Navigation

The navigation tab is an interface for mapping key shortcuts related to moving around tmux and the Honeymux interface.

Here is one possible approach:

• Prev Pane: Ctrl+Lt, Next Pane: Ctrl+Rt²
• Prev Window: Alt+Lt, Next Window: Alt+Rt
• Prev Session: Ctrl+Alt+Lt, Next Session: Ctrl+Alt+Rt
• Sidebar: Shift+Lt, Toolbar: Shift+Rt

Note that this leaves Ctrl+Alt+Shift+Lt/Rt free for lesser-used navigation gestures if needed. And on a Mac, Cmd+Lt/Rt remain available for switching tabs at the outer emulator level.

Tip

On macOS, the ^ ← (Ctrl+Lt) and ^ → (Ctrl+Rt) key combinations are assigned to Mission Control by default. To free them up for use with Honeymux, visit System Settings → Keyboard → Keyboard Shortcuts → Mission Control → Mission Control and uncheck the “Move left a space” and “Move right a space” options.

Tip

In Ghostty, you can free up Alt+Lt and Alt+Rt with the following configuration settings:

keybind = alt+left=unbind
keybind = alt+right=unbind

Agents

The agents tab is where key shortcuts are set for the agent monitoring latch and hotkeys for responding to agent permission hooks.

• Latch: Switch keyboard focus to the agent
• Approve: Send an approve response to the agent
• Deny: Send a deny response to the agent
• Go to pane: Switch focus to the pane where agent running
• Dismiss: Dismiss the notification, but keep the agent in unanswered state

All of these actions can also be activated by mouse click.

About

The about tab shows versioning information as well as the detected terminal emulator and advertised capabilities.

Tip

Key bindings may be modified by manual edit of ~/.config/honeymux/keybindings.json also.

Footnotes

1. Requires terminal emulator to support the kitty keyboard protocol. ↩

2. Note that if the Pane Tabs feature is enabled, the pane navigation keys will cycle between both panes and pane tabs (if any). ↩