Curflow

Product Introduction

1. Definition: Curflow is a native macOS productivity utility and gesture-recognition engine designed to transform the cursor into a multifunctional navigation and automation tool. Categorized as a system-level gesture enhancement software, it allows users to trigger complex system actions, keyboard shortcuts, and automation scripts through directional mouse movements (Right-click + Gesture) or trackpad inputs (Option + Pan).

2. Core Value Proposition: Curflow exists to bridge the gap between high-precision cursor movement and complex keyboard-driven commands. By eliminating the need for "keyboard gymnastics," it optimizes ergonomic efficiency for Mac users. The primary value proposition is "Stay on the mouse, stay on the trackpad," enabling a zero-latency workflow where the cursor acts as the primary interface for window management, tab control, and application navigation.

Main Features

1. Omni-Directional Context Engine: Curflow utilizes a sophisticated recognition engine written in native Swift that interprets the dominant direction of a cursor's path rather than requiring pixel-perfect calligraphy. This allows for seven primary gestures—including flick, swipe, and directional drags—to be mapped to actions like browser navigation (Forward/Back), tab management (Close/New), and clipboard operations (Copy/Paste). The engine operates with a tolerance for imprecision, ensuring high success rates even during rapid movements.

2. Dynamic Shortcut Mapping & Context Awareness: Any system-wide or app-specific keyboard shortcut can be mapped to a custom gesture. Using a three-column configuration interface, users can define the scope of a gesture (Global, Chrome, Finder, VS Code, etc.), choose the trigger movement, and assign the resulting action. This feature supports complex combinations such as Mission Control (^↑), Spotlight (⌘ Space), or specialized commands within creative suites like Figma and Final Cut Pro.

3. Advanced Automation with AppleScript and Sequences: Moving beyond simple shortcuts, Curflow integrates with the macOS automation ecosystem. Users can trigger AppleScript routines for batch file management, system setting toggles, or Shortcuts.app workflows. The "Action Sequences" feature allows for the chaining of multiple steps—such as opening a project, starting a local server, and launching a browser—into a single physical movement of the wrist.

4. Native Performance Architecture: Built specifically for macOS 14+ and Apple Silicon, Curflow leverages direct access to the macOS event system. This architectural choice ensures near-zero CPU overhead and a battery impact of less than 0.1% daily. Because it does not rely on active polling loops, it maintains 100% native performance without introducing input lag or interfering with native macOS trackpad gestures like Mission Control or Desktop Swiping.

Problems Solved

1. Pain Point: Repetitive Keyboard Strain and Context Switching: For power users, moving the hand from the mouse to the keyboard for common tasks (like ⌘+W to close a tab or ⌘+Tab to switch apps) creates micro-frictions that break focus. Curflow solves this by centralizing these commands at the cursor tip, reducing physical fatigue and cognitive load.

2. Target Audience:

• Creative Professionals: UI/UX designers in Figma or video editors in Final Cut who need to maintain focus on the canvas while triggering tools.
• Software Developers: Engineers using Xcode or VS Code who navigate complex directory structures and multiple terminal tabs.
• General Power Users: Individuals who find the standard Apple Magic Mouse gestures limited or those using third-party ergonomic mice that lack native macOS gesture support.
• MacBook Users: Trackpad enthusiasts looking to extend macOS functionality beyond the standard three-finger and four-finger system gestures.

3. Use Cases:

• Browser Management: Rapidly closing dozens of tabs or navigating page history in Safari/Chrome using only right-click flicks.
• System Control: Triggering screenshots (⌘⇧5) or Mission Control without reaching for the Function row.
• Development Workflows: Mapping a "draw circle" gesture to run a build script or clear a cache.
• File Organization: Using gestures in Finder to move selected files to specific folders via AppleScript.

Unique Advantages

1. Differentiation: Unlike traditional gesture tools that are often bloated or cross-platform ports, Curflow is a "Mac-first" utility. It provides the "Apple Magic Mouse experience" on any third-party mouse (Logitech, Razer, etc.) while allowing trackpad users to bypass the limitations of the standard macOS System Settings. It distinguishes itself through its "Lifetime License" model, rejecting the industry trend of recurring subscriptions.

2. Key Innovation: The "Per-App Vocabulary" system is a significant innovation. It allows the same physical gesture to perform different, contextually relevant tasks depending on the active window. A "swipe down" might minimize a window globally, but in a code editor, it could trigger a "Go to Definition" command. This contextual intelligence maximizes the utility of a limited number of easy-to-remember gestures.

Frequently Asked Questions (FAQ)

1. Does Curflow work with third-party mice like Logitech or Razer? Yes. Curflow is designed to provide full gesture control on any mouse. By using the Right-click + Gesture trigger, it enables Magic Mouse-style functionality on hardware that typically lacks native macOS gesture support.

2. How does Curflow affect MacBook battery life? The impact is negligible. Curflow is written in native Swift and integrates directly with the macOS event system. It only consumes resources when a gesture is actively being drawn, resulting in less than 0.1% battery usage in a typical 24-hour cycle.

3. Can I use Curflow alongside native macOS trackpad gestures? Absolutely. Curflow does not override or interfere with native macOS gestures like three-finger swipes for Mission Control. It uses the "Option Key + Pan" trigger for trackpads, ensuring that your existing muscle memory for system gestures remains intact.

4. What happens if my gesture is not perfectly straight or circular? Curflow features a recognition engine built for real-world usage. It analyzes the dominant intent and direction of the movement rather than the exact geometric shape. This makes it highly tolerant of "imprecise" or "sloppy" movements, ensuring the action triggers correctly every time.