Keysi

Product Introduction

1. Definition: Keysi is a macOS utility application (category: Productivity/System Enhancement) that provides real-time, contextual keyboard shortcut discovery and learning. It functions as an intelligent overlay and coaching tool, reading menu structures directly from the active application's Accessibility API.
2. Core Value Proposition: Keysi exists to eliminate the friction of discovering, remembering, and adopting keyboard shortcuts, thereby accelerating workflow efficiency and reducing reliance on the mouse. Its primary value is delivering a live, interactive cheat sheet for any Mac app and proactively teaching shortcuts through spaced repetition and contextual reminders.

Main Features

1. Live Shortcut Overlay: The core feature activates by holding a modifier key (⌘, ⌥, ⌃, ⇧). Keysi uses the public macOS Accessibility API (AXUIElementCreateApplication, menu-bar attributes) to parse the active application's menu hierarchy in real-time, rendering a searchable, categorized panel of every available keyboard shortcut. Each row is clickable to execute the command directly.
2. Shortcut Coach (Pro Feature): An active learning system that monitors user interaction. When a user selects a menu command via mouse that has an assigned keyboard shortcut, Keysi Pro displays a single, non-intrusive notification as a reminder. It employs a cooldown algorithm to prevent notification fatigue and tracks which shortcuts the user has successfully adopted.
3. Practice Mode with Spaced Repetition (Pro Feature): A drill-based training module that uses a spaced repetition algorithm (SRS) to reinforce memory. Shortcuts the user frequently misses are presented in drills, with increasing intervals (e.g., 1 day, 2 days, 4 days) upon correct recall. The system uses actual, timed menu interactions as its baseline metric for measuring efficiency gains.
4. Advanced Shortcut Management: Keysi extends beyond native menus. It can import and parse custom keybindings from developer environments like VS Code, JetBrains IDEs, Xcode, and Sublime Text, displaying them in a dedicated "Your keymap" section. It also includes pre-built cheat sheets for tools with sparse menus (e.g., Vim, tmux, Figma, Linear) and warns of conflicts with system-level or other application hotkeys.
5. Cross-Platform Sync & Integration: A file-based sync engine (using a user-designated folder like iCloud Drive) synchronizes custom sheets, favorites, and settings across multiple Macs. Keysi Pro offers extensive automation via a keysi:// URL scheme, a terminal command, and integrations with Raycast and Alfred for external triggering and data access.

Problems Solved

1. Pain Point: The discoverability and memorability gap for keyboard shortcuts. Users waste time navigating nested menus or searching outdated documentation, hindering muscle memory development and slowing down complex workflows in professional applications like Xcode, Final Cut Pro, or Logic Pro.
2. Target Audience: Power users and professionals whose efficiency is tied to application mastery, including software developers, video editors, audio engineers, graphic designers, data analysts, and writers. It specifically targets users transitioning from the discontinued CheatSheet app or seeking a more proactive alternative to passive reference tools.
3. Use Cases: Essential for onboarding to a new complex application; mastering a professional creative or development suite; standardizing shortcuts across a team; recovering productivity after a major application update that changes shortcuts; and auditing personal efficiency by quantifying mouse-to-keyboard transitions.

Unique Advantages

1. Strengths & Limitations (Pros & Cons):

   • Pros:
     • Contextual & Live: Reads actual app menus, ensuring accuracy unlike static PDF guides.
     • Proactive Coaching: Unique "Coach" feature actively reduces dependency on the mouse, a key differentiator.
     • Fair Pricing Model: Clear, permanent free tier; Pro is a one-time purchase, not a subscription.
     • Deep Technical Integration: Handles rebinded keys from major IDEs and warns of system shortcut conflicts.
     • Privacy-Focused: Analytics and crash reporting are opt-in, not default.
   • Cons:
     • macOS Limitation: Requires Accessibility permission and cannot be sandboxed, thus is not available on the Mac App Store.
     • No In-Overlay Search: Cannot filter the overlay while holding the modifier key; must use the separate panel hotkey (⇧⌘K).
     • Dependency on App Menus: For applications that do not expose standard menus (some games, full-screen custom UIs), functionality is limited unless a custom sheet is created.

2. Key Alternatives & Differentiation:

   • CheatSheet (Discontinued): Keysi's direct inspiration. Keysi differentiates itself by being actively maintained for modern macOS, offering proactive coaching (Pro), conflict detection, and custom sheet support, which CheatSheet lacked.
   • KeyCue: A established, subscription-based competitor (~$19.99/year). Keysi's primary differentiation is pricing and feature allocation. KeyCue charges a recurring fee for the basic overlay functionality that Keysi provides for free. Keysi Pro's one-time fee focuses payment on the unique coaching and learning features.
   • KeyClu / Keylume: These are free alternatives. Keysi differentiates by offering more advanced features like spaced-repetition Practice Mode, detailed progress analytics ("Your Keysi"), system shortcut conflict warnings, and robust support for custom keymaps and sheets, justifying the Pro tier's cost for serious users.

Frequently Asked Questions (FAQ)

1. Is Keysi a safe app to install on Mac? Yes. Keysi is signed with an Apple Developer ID and notarized, meaning it has passed Apple's malware checks. It requires Accessibility permission solely to read menu structures (AXUIElement APIs) as stated in the prompt. It does not log keystrokes or control input without explicit user click interaction on its overlay.

2. How does Keysi Pro's coaching work to teach me shortcuts? Keysi Pro's Coach mode runs silently in the background. When you use your mouse or trackpad to select a menu item that has a keyboard shortcut, it displays a single, dismissible notification showing that shortcut. It tracks which shortcuts you subsequently use, stopping reminders for those you've adopted. This method uses your actual workflow behavior for contextual, just-in-time learning.

3. Can I use Keysi with applications like VS Code where I've customized my keybindings? Absolutely. A significant feature of Keysi is its ability to read and display custom keybinding files (e.g., keybindings.json for VS Code/ Cursor, keymaps/ for JetBrains, .vimrc). These user-defined shortcuts appear in a separate "Your keymap" group alongside the standard menu shortcuts, providing a complete view of your personal setup.

4. What happens when my Keysi Pro trial ends? The application reverts to the fully-featured free tier without interruption. You retain access to the live overlay, click-to-run, custom sheets, conflict warnings, and one Practice drill per day. You lose access to the proactive Coach reminders, unlimited Practice Mode, progress analytics ("Your Keysi"), and the "New" marks for updated shortcuts. You can upgrade later to restore these features.

5. Why isn't Keysi available on the Mac App Store? The macOS Accessibility APIs that Keysi relies on to read other applications' menus are incompatible with the App Sandbox, a mandatory security requirement for all Mac App Store apps. Therefore, like many similar utilities (KeyCue, KeyClu, the original CheatSheet), it must be distributed directly via its website or Homebrew.