GroupShelf

Product Introduction

1. Definition: GroupShelf is a native macOS utility application that functions as a system-level window management tool. It introduces a tabbed interface, similar to a web browser, for grouping windows from any application on the desktop.
2. Core Value Proposition: GroupShelf exists to eliminate desktop clutter and streamline workflow context switching on macOS. Its primary value is providing a lightweight, native method to organize disparate application windows—like Finder, code editors, terminals, and browsers—into cohesive, manageable groups that move and resize as a single unit, thereby enhancing productivity and reducing cognitive load.

Main Features

1. Universal App Window Grouping: GroupShelf's core functionality allows windows from any macOS application to be tabbed together, regardless of the app's origin (native AppKit, Qt, Electron, etc.). This is achieved by leveraging macOS's Accessibility APIs to read window positions and titles. The technology ensures window frames can be manipulated in unison without accessing private application data.
2. Intuitive Shift-Drag Merging: The primary user interaction model involves holding the Shift key (configurable) and dragging one window's title bar onto another. This action programmatically merges the windows into a tabbed group. Conversely, dragging a tab out of the group performs a split operation, restoring it to a standalone window. This direct manipulation paradigm requires no complex menus or mode switching.
3. Keyboard-Centric Tab Navigation: Beyond mouse control, GroupShelf enables efficient keyboard workflow with a default shortcut (Control + Option + Arrow Keys) to cycle through tabs within the active group. This shortcut is fully customizable in the app's Settings, catering to power users who prefer to keep their hands on the keyboard for rapid context switching.
4. Visual Group Identification & Management: Each tab group, or "shelf," can be assigned a custom accent color and name for instant visual identification across a multi-monitor setup or crowded desktop. The architecture supports creating an unlimited number of independent groups, allowing for organization by project, task, or any user-defined category.
5. Native macOS Performance: Built directly with Apple's AppKit framework, GroupShelf is a lightweight binary with minimal system resource consumption. It avoids cross-platform frameworks like Electron, resulting in near-instantaneous response, negligible battery impact, and deep integration with macOS 15+ semantics on both Apple Silicon and Intel architectures.

Problems Solved

1. Pain Point: It solves the problem of desktop and window management chaos, where users struggle with overlapping, disorganized windows from multiple applications, leading to lost focus, time wasted searching, and inefficient screen real estate use.
2. Target Audience: The tool is essential for power users and professionals including software developers (managing IDE, terminal, and browser windows), digital creatives (grouping design tools, asset browsers, and communication apps), researchers/writers (organizing reference PDFs, notes, and word processors), and multi-tasking knowledge workers who routinely juggle numerous applications.
3. Use Cases: Specific scenarios include: grouping all windows related to a single coding project (Xcode, Terminal, Safari for documentation); organizing research materials for an article (Preview, Bear, Safari tabs); keeping communication tools (Slack, Discord, Mail) neatly contained in one resizable group; or managing all file system windows for a complex file organization task in a single tabbed Finder shelf.

Unique Advantages

1. Differentiation: Unlike virtual desktop/spaces (which hide context) or tiling window managers (which enforce a rigid layout), GroupShelf offers flexible, persistent visual grouping without altering the native windowing behavior of individual apps. It differs from other tabbing utilities by being app-agnostic, not requiring per-app support, and offering a one-time purchase model versus subscriptions.
2. Key Innovation: The key technical innovation is the application of a consistent, browser-like tabbing metaphor at the operating system level for all windows, enabled by a precise, non-intrusive use of macOS's Accessibility framework solely for spatial window management. The simple modifier-key drag-to-merge interaction is a refined user experience innovation that makes powerful organization instantly accessible.

Frequently Asked Questions (FAQ)

1. Is GroupShelf available on the Mac App Store? No, GroupShelf is a direct download due to macOS App Store sandbox restrictions, which block the necessary Accessibility permission. This permission is used only to read window positions and titles to enable grouping and moving; it does not access window content, keystrokes, or transmit any data from your Mac.
2. How does the GroupShelf license and activation work? GroupShelf uses a one-time purchase lifetime license for version 1.x, managed via the Polar payment platform. A single license key activates the software on up to 3 personal Macs. Activation and device management are handled through a customer portal, where users can retrieve keys or deactivate devices.
3. What are the system requirements for GroupShelf? GroupShelf requires macOS 15 (Sequoia) or later. It is a universal binary compatible with both Apple Silicon (M-series) and Intel-based Mac computers. The 30-day full-feature trial requires no payment details.
4. Can I use GroupShelf with window management tools like Rectangle or Magnet? Yes, GroupShelf is complementary to window snapping tools. You can use a tool like Rectangle to quickly arrange a window group's overall position and size on screen, while GroupShelf manages the internal tab organization of the applications within that arranged space.
5. Does GroupShelf work with full-screen or Stage Manager windows? GroupShelf operates on standard desktop windows. It is not designed to group windows that are in macOS's full-screen mode or within Stage Manager's isolated stages, as these are separate windowing contexts managed exclusively by the operating system.