Skip to content

HarshalPatel1972/keyflex

Repository files navigation

🔥 Keyflex

Flex your keys. Own your machine.

Rust Tauri v2 TypeScript Windows License MIT


I realized I'd been using computers for years but had zero visibility into how I actually used them. I'd reach for the mouse constantly, forget shortcuts I once knew, and have no idea which ones I was missing entirely. Every existing tool either logged everything — a privacy nightmare — or just counted keystrokes, which is useless. I wanted something that watched for the smart stuff, the combos — and showed me the gap between who I am at the keyboard and who I could be. So I built Keyflex.

What it does

  • ⌨️ Privacy-safe capture — Tracks only modifier combinations (Ctrl+C, Alt+Tab). If no modifier key is held, the event is discarded immediately. Your keystrokes are never logged.
  • 🔥 Live keyboard heatmap — A full keyboard visualization where every key glows hotter the more you use it in shortcuts.
  • 🔓 Gap analysis — Surfaces high-value shortcuts you've never pressed, framed as unlockable abilities — not failures.
  • 📊 Per-app breakdown — Chrome, VS Code, Windows system, any app — tracked separately with its own charts and stats.
  • ⚡ Efficiency score — A 0–100 score combining variety, volume, and streak consistency.
  • 🎮 Streaks & milestones — Daily streaks, achievement unlocks, and a contribution grid for your shortcut history.
  • 🪟 System tray — Runs silently in the background. Opens a dashboard when you want it, disappears when you don't.

Privacy

Keyflex's privacy is architectural, not a promise:

  • The hook callback checks for a modifier key being held before any data is saved. Non-modifier keypresses are discarded in the same stack frame — no buffer, no log.
  • All data is stored in a local SQLite database at %APPDATA%/keyflex/keyflex.db. Nothing leaves your machine.
  • No telemetry, no analytics, no network calls.

Installation

Download the latest installer from Releases:

  • Keyflex_0.1.0_x64_en-US.msi — Windows Installer
  • Keyflex_0.1.0_x64-setup.exe — NSIS Installer

Building from source

# Prerequisites: Rust stable, Node 20+
git clone https://github.com/HarshalPatel1972/keyflex.git
cd keyflex
npm install
npm run tauri dev        # development
npm run tauri build      # production installer

Tech Stack

Layer Choice
Shell Tauri v2
Core / Hook Rust + windows-rs
Storage SQLite via rusqlite (bundled)
UI React 18 + TypeScript
Charts Recharts
Build Vite

Screenshots

Roadmap

  • Mouse escape rate tracking (WH_MOUSE_LL frequency analysis)
  • Weekly shareable stats card (PNG export)
  • Custom shortcut definitions (import VS Code keybindings.json)
  • macOS support
  • Shortcut suggestion engine (AI-powered, local)

Contributing

Issues and PRs welcome. Please follow conventional commits: type(scope): description.


Built with frustration and too many mouse clicks by Harshal Patel.

About

Flex your keys. Own your machine. A privacy-safe keyboard shortcut tracker and mastery engine.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors