first pass of merging in warp (doesn't build)

2026-07-01 16:08:58 -05:00
parent 2f64909469
commit 4770ac06b5
3662 changed files with 414574 additions and 89772 deletions
@@ -0,0 +1,71 @@
+# Hide Warp Dock Icon — Product Spec
+
+## Summary
+
+Add a macOS-only setting that lets users hide Warp from the Dock and Cmd-Tab app switcher while Warp continues running. This is intended for users who primarily launch or focus Warp via a global hotkey and do not want Warp to occupy Dock or app-switcher space.
+
+## Motivation
+
+Users who primarily use Warp through the dedicated hotkey window or another global hotkey do not need a persistent Dock icon. The icon occupies Dock and Cmd-Tab space, and clicking it can open a normal Warp window separate from the user's hotkey workflow. Users currently resort to unsupported bundle edits that are reverted by updates and can leave broken Dock state.
+
+## Goals
+
+- Provide a macOS setting to show or hide Warp's Dock icon.
+- Hide Warp from both the Dock and Cmd-Tab switcher when the setting is off.
+- Keep the setting independent of the global hotkey mode; users can hide the Dock icon whether global hotkey is disabled, dedicated hotkey window is enabled, or show/hide-all-windows hotkey is enabled.
+- Preserve existing app icon customization when the Dock icon is visible.
+
+## Non-goals
+
+- Changing Warp's default behavior. Existing users should continue to see Warp in the Dock unless they opt out.
+- Adding a menu bar/status bar icon as part of this PR.
+- Changing the icon art options added for the Dock icon; hiding the Dock icon is a separate presentation setting, not another icon style.
+- Implementing equivalent Dock/taskbar hiding behavior on Windows, Linux, or web.
+
+## User experience
+
+### Settings
+
+1. On macOS, settings include a user-facing control for Dock visibility near the existing app icon customization controls.
+2. The default is to show Warp in the Dock.
+3. Turning the setting off immediately removes Warp from the Dock and Cmd-Tab switcher.
+4. Turning the setting back on immediately restores Warp to the Dock and Cmd-Tab switcher.
+5. The setting is hidden or unsupported on non-macOS platforms.
+
+### Hidden Dock icon state
+
+1. When the Dock icon is hidden, Warp remains running and existing terminal sessions continue unaffected.
+2. Warp does not appear in the Dock.
+3. Warp does not appear in Cmd-Tab.
+4. Users can still access Warp through configured global hotkeys, existing visible windows, Mission Control, or other macOS window-management surfaces.
+
+### Global hotkey interaction
+
+1. The setting is independent of dedicated hotkey window mode.
+2. If a user has dedicated hotkey window mode enabled, hiding the Dock icon does not change hotkey behavior.
+3. If a user uses show/hide-all-windows global hotkey mode, hiding the Dock icon does not change that behavior.
+4. Hiding the Dock icon does not enable a global hotkey, change an existing global hotkey, or require one.
+
+### Persistence and launch
+
+1. The hidden Dock icon preference persists across restart.
+2. On launch, Warp should apply the saved Dock visibility preference as early as practical so the Dock icon does not visibly linger longer than necessary.
+3. If applying the hidden Dock state fails, Warp should leave the app in the safe visible-Dock state.
+
+## Acceptance criteria
+
+1. A macOS user can disable the Dock icon from settings and immediately no longer sees Warp in the Dock.
+2. With the Dock icon disabled, Warp is absent from Cmd-Tab.
+3. Re-enabling the Dock icon restores Dock and Cmd-Tab presence.
+4. The setting persists across restart.
+5. Existing app icon customization continues to affect the Dock icon when the Dock icon is visible.
+6. Non-macOS users do not see an enabled no-op Dock visibility setting.
+
+## Manual test plan
+
+- On macOS, manually toggle the setting off and verify Warp disappears from the Dock and Cmd-Tab while remaining running.
+- Verify a configured global hotkey can still show/focus Warp while the Dock icon is hidden.
+- Toggle the setting back on and verify the Dock icon and Cmd-Tab entry return.
+- Restart Warp with the setting off and verify the hidden Dock state is restored.
+- Verify the setting is not shown as enabled on non-macOS platforms.
+- Verify existing app icon customization still works when Dock visibility is on.