macOS default cmd+? keybind

[memco]

On macOS cmd+? is a global shortcut to open the mac help menu which by default enables you to search the other menu items for some action to take (sort of like cmd+p in a lot of editors). Ghostty has this shortcut bound to a different action which opens the Ghostty github discussion page. How can I get back the ability to use cmd+? to open the help search?

[rhodes-b]

Ghostty should not have this bound by default
in fact it doesnt even seem like you can bind ? according to

ghostty/src/input/key.zig

Lines 255 to 402 in d6e7685

	pub const Key = enum(c_int) {
	invalid,
	// a-z
	a,
	b,
	c,
	d,
	e,
	f,
	g,
	h,
	i,
	j,
	k,
	l,
	m,
	n,
	o,
	p,
	q,
	r,
	s,
	t,
	u,
	v,
	w,
	x,
	y,
	z,
	// numbers
	zero,
	one,
	two,
	three,
	four,
	five,
	six,
	seven,
	eight,
	nine,
	// puncuation
	semicolon,
	space,
	apostrophe,
	comma,
	grave_accent, // `
	period,
	slash,
	minus,
	plus,
	equal,
	left_bracket, // [
	right_bracket, // ]
	backslash, // /
	// control
	up,
	down,
	right,
	left,
	home,
	end,
	insert,
	delete,
	caps_lock,
	scroll_lock,
	num_lock,
	page_up,
	page_down,
	escape,
	enter,
	tab,
	backspace,
	print_screen,
	pause,
	// function keys
	f1,
	f2,
	f3,
	f4,
	f5,
	f6,
	f7,
	f8,
	f9,
	f10,
	f11,
	f12,
	f13,
	f14,
	f15,
	f16,
	f17,
	f18,
	f19,
	f20,
	f21,
	f22,
	f23,
	f24,
	f25,
	// keypad
	kp_0,
	kp_1,
	kp_2,
	kp_3,
	kp_4,
	kp_5,
	kp_6,
	kp_7,
	kp_8,
	kp_9,
	kp_decimal,
	kp_divide,
	kp_multiply,
	kp_subtract,
	kp_add,
	kp_enter,
	kp_equal,
	kp_separator,
	kp_left,
	kp_right,
	kp_up,
	kp_down,
	kp_page_up,
	kp_page_down,
	kp_home,
	kp_end,
	kp_insert,
	kp_delete,
	kp_begin,
	// TODO: media keys
	// modifiers
	left_shift,
	left_control,
	left_alt,
	left_super,
	right_shift,
	right_control,
	right_alt,
	right_super,

nor is it bound below for all of the default keybinds

ghostty/src/config/Config.zig

Lines 1907 to 2422 in d6e7685

	// Add our default keybindings
	// keybinds for opening and reloading config
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .comma }, .mods = inputpkg.ctrlOrSuper(.{ .shift = true }) },
	.{ .reload_config = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .comma }, .mods = inputpkg.ctrlOrSuper(.{}) },
	.{ .open_config = {} },
	);
	{
	// On macOS we default to super but Linux ctrl+shift since
	// ctrl+c is to kill the process.
	const mods: inputpkg.Mods = if (builtin.target.isDarwin())
	.{ .super = true }
	else
	.{ .ctrl = true, .shift = true };
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .c }, .mods = mods },
	.{ .copy_to_clipboard = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .v }, .mods = mods },
	.{ .paste_from_clipboard = {} },
	);
	}
	// Increase font size mapping for keyboards with dedicated plus keys (like german)
	// Note: this order matters below because the C API will only return
	// the last keybinding for a given action. The macOS app uses this to
	// set the expected keybind for the menu.
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .plus }, .mods = inputpkg.ctrlOrSuper(.{}) },
	.{ .increase_font_size = 1 },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .equal }, .mods = inputpkg.ctrlOrSuper(.{}) },
	.{ .increase_font_size = 1 },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .minus }, .mods = inputpkg.ctrlOrSuper(.{}) },
	.{ .decrease_font_size = 1 },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .zero }, .mods = inputpkg.ctrlOrSuper(.{}) },
	.{ .reset_font_size = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .j }, .mods = inputpkg.ctrlOrSuper(.{ .shift = true }) },
	.{ .write_scrollback_file = .paste },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .j }, .mods = inputpkg.ctrlOrSuper(.{ .shift = true, .alt = true }) },
	.{ .write_scrollback_file = .open },
	);
	// Expand Selection
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .left }, .mods = .{ .shift = true } },
	.{ .adjust_selection = .left },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .right }, .mods = .{ .shift = true } },
	.{ .adjust_selection = .right },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .up }, .mods = .{ .shift = true } },
	.{ .adjust_selection = .up },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .down }, .mods = .{ .shift = true } },
	.{ .adjust_selection = .down },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .page_up }, .mods = .{ .shift = true } },
	.{ .adjust_selection = .page_up },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .page_down }, .mods = .{ .shift = true } },
	.{ .adjust_selection = .page_down },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .home }, .mods = .{ .shift = true } },
	.{ .adjust_selection = .home },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .end }, .mods = .{ .shift = true } },
	.{ .adjust_selection = .end },
	);
	// Tabs common to all platforms
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .tab }, .mods = .{ .ctrl = true, .shift = true } },
	.{ .previous_tab = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .tab }, .mods = .{ .ctrl = true } },
	.{ .next_tab = {} },
	);
	// Windowing
	if (comptime !builtin.target.isDarwin()) {
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .n }, .mods = .{ .ctrl = true, .shift = true } },
	.{ .new_window = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .w }, .mods = .{ .ctrl = true, .shift = true } },
	.{ .close_surface = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .q }, .mods = .{ .ctrl = true, .shift = true } },
	.{ .quit = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .f4 }, .mods = .{ .alt = true } },
	.{ .close_window = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .t }, .mods = .{ .ctrl = true, .shift = true } },
	.{ .new_tab = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .left }, .mods = .{ .ctrl = true, .shift = true } },
	.{ .previous_tab = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .right }, .mods = .{ .ctrl = true, .shift = true } },
	.{ .next_tab = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .page_up }, .mods = .{ .ctrl = true } },
	.{ .previous_tab = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .page_down }, .mods = .{ .ctrl = true } },
	.{ .next_tab = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .o }, .mods = .{ .ctrl = true, .shift = true } },
	.{ .new_split = .right },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .e }, .mods = .{ .ctrl = true, .shift = true } },
	.{ .new_split = .down },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .left_bracket }, .mods = .{ .ctrl = true, .super = true } },
	.{ .goto_split = .previous },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .right_bracket }, .mods = .{ .ctrl = true, .super = true } },
	.{ .goto_split = .next },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .up }, .mods = .{ .ctrl = true, .alt = true } },
	.{ .goto_split = .top },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .down }, .mods = .{ .ctrl = true, .alt = true } },
	.{ .goto_split = .bottom },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .left }, .mods = .{ .ctrl = true, .alt = true } },
	.{ .goto_split = .left },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .right }, .mods = .{ .ctrl = true, .alt = true } },
	.{ .goto_split = .right },
	);
	// Resizing splits
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .up }, .mods = .{ .super = true, .ctrl = true, .shift = true } },
	.{ .resize_split = .{ .up, 10 } },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .down }, .mods = .{ .super = true, .ctrl = true, .shift = true } },
	.{ .resize_split = .{ .down, 10 } },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .left }, .mods = .{ .super = true, .ctrl = true, .shift = true } },
	.{ .resize_split = .{ .left, 10 } },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .right }, .mods = .{ .super = true, .ctrl = true, .shift = true } },
	.{ .resize_split = .{ .right, 10 } },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .equal }, .mods = .{ .super = true, .ctrl = true, .shift = true } },
	.{ .equalize_splits = {} },
	);
	// Viewport scrolling
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .home }, .mods = .{ .shift = true } },
	.{ .scroll_to_top = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .end }, .mods = .{ .shift = true } },
	.{ .scroll_to_bottom = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .page_up }, .mods = .{ .shift = true } },
	.{ .scroll_page_up = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .page_down }, .mods = .{ .shift = true } },
	.{ .scroll_page_down = {} },
	);
	// Semantic prompts
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .page_up }, .mods = .{ .shift = true, .ctrl = true } },
	.{ .jump_to_prompt = -1 },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .page_down }, .mods = .{ .shift = true, .ctrl = true } },
	.{ .jump_to_prompt = 1 },
	);
	// Inspector, matching Chromium
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .i }, .mods = .{ .shift = true, .ctrl = true } },
	.{ .inspector = .toggle },
	);
	// Terminal
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .a }, .mods = .{ .shift = true, .ctrl = true } },
	.{ .select_all = {} },
	);
	// Selection clipboard paste
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .insert }, .mods = .{ .shift = true } },
	.{ .paste_from_selection = {} },
	);
	}
	{
	// Cmd+N for goto tab N
	const start = @intFromEnum(inputpkg.Key.one);
	const end = @intFromEnum(inputpkg.Key.nine);
	var i: usize = start;
	while (i <= end) : (i += 1) {
	// On macOS we default to super but everywhere else
	// is alt.
	const mods: inputpkg.Mods = if (builtin.target.isDarwin())
	.{ .super = true }
	else
	.{ .alt = true };
	try result.keybind.set.put(
	alloc,
	.{
	// On macOS, we use the physical key for tab changing so
	// that this works across all keyboard layouts. This may
	// want to be true on other platforms as well but this
	// is definitely true on macOS so we just do it here for
	// now (#817)
	.key = if (comptime builtin.target.isDarwin())
	.{ .physical = @enumFromInt(i) }
	else
	.{ .translated = @enumFromInt(i) },
	.mods = mods,
	},
	.{ .goto_tab = (i - start) + 1 },
	);
	}
	}
	// Toggle fullscreen
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .enter }, .mods = inputpkg.ctrlOrSuper(.{}) },
	.{ .toggle_fullscreen = {} },
	);
	// Toggle zoom a split
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .enter }, .mods = inputpkg.ctrlOrSuper(.{ .shift = true }) },
	.{ .toggle_split_zoom = {} },
	);
	// Mac-specific keyboard bindings.
	if (comptime builtin.target.isDarwin()) {
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .q }, .mods = .{ .super = true } },
	.{ .quit = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .k }, .mods = .{ .super = true } },
	.{ .clear_screen = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .a }, .mods = .{ .super = true } },
	.{ .select_all = {} },
	);
	// Viewport scrolling
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .home }, .mods = .{ .super = true } },
	.{ .scroll_to_top = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .end }, .mods = .{ .super = true } },
	.{ .scroll_to_bottom = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .page_up }, .mods = .{ .super = true } },
	.{ .scroll_page_up = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .page_down }, .mods = .{ .super = true } },
	.{ .scroll_page_down = {} },
	);
	// Semantic prompts
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .up }, .mods = .{ .super = true, .shift = true } },
	.{ .jump_to_prompt = -1 },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .down }, .mods = .{ .super = true, .shift = true } },
	.{ .jump_to_prompt = 1 },
	);
	// Mac windowing
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .n }, .mods = .{ .super = true } },
	.{ .new_window = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .w }, .mods = .{ .super = true } },
	.{ .close_surface = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .w }, .mods = .{ .super = true, .shift = true } },
	.{ .close_window = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .w }, .mods = .{ .super = true, .shift = true, .alt = true } },
	.{ .close_all_windows = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .t }, .mods = .{ .super = true } },
	.{ .new_tab = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .left_bracket }, .mods = .{ .super = true, .shift = true } },
	.{ .previous_tab = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .right_bracket }, .mods = .{ .super = true, .shift = true } },
	.{ .next_tab = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .physical = inputpkg.Key.zero }, .mods = .{ .super = true } },
	.{ .last_tab = {} },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .d }, .mods = .{ .super = true } },
	.{ .new_split = .right },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .d }, .mods = .{ .super = true, .shift = true } },
	.{ .new_split = .down },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .left_bracket }, .mods = .{ .super = true } },
	.{ .goto_split = .previous },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .right_bracket }, .mods = .{ .super = true } },
	.{ .goto_split = .next },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .up }, .mods = .{ .super = true, .alt = true } },
	.{ .goto_split = .top },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .down }, .mods = .{ .super = true, .alt = true } },
	.{ .goto_split = .bottom },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .left }, .mods = .{ .super = true, .alt = true } },
	.{ .goto_split = .left },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .right }, .mods = .{ .super = true, .alt = true } },
	.{ .goto_split = .right },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .up }, .mods = .{ .super = true, .ctrl = true } },
	.{ .resize_split = .{ .up, 10 } },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .down }, .mods = .{ .super = true, .ctrl = true } },
	.{ .resize_split = .{ .down, 10 } },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .left }, .mods = .{ .super = true, .ctrl = true } },
	.{ .resize_split = .{ .left, 10 } },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .right }, .mods = .{ .super = true, .ctrl = true } },
	.{ .resize_split = .{ .right, 10 } },
	);
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .equal }, .mods = .{ .shift = true, .alt = true } },
	.{ .equalize_splits = {} },
	);
	// Inspector, matching Chromium
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .i }, .mods = .{ .alt = true, .super = true } },
	.{ .inspector = .toggle },
	);
	// Alternate keybind, common to Mac programs
	try result.keybind.set.put(
	alloc,
	.{ .key = .{ .translated = .f }, .mods = .{ .super = true, .ctrl = true } },
	.{ .toggle_fullscreen = {} },
	);
	}

[rhodes-b]

Afaik if its bound at the os level like you are describing it wouldnt even be sent to ghostty anyways

[rhodes-b]

#3187
shows it shouldnt take anything bound at the os level if it exists

[rrotter]

It's working to open the Help menu for me. Is it possible you have some other remapping in play here? karabiner, bettertouchtool, etc?

[memco]

It may only be in the beta releases in the one version I have (Version 4b3c1b0, build 8484), but it definitely has Ghostty Help bound to cmd+?:

Maybe this is relevant: menu code seems to associate it with ?? Anyway it's not happening in the stable version or in the latest beta (Version 6cbd69d, build 8515) so maybe it's an isolated incident.