Skip to content

Repository files navigation

🌌 Mayzyyy Command

An intelligent, neurodivergent-first scheduling desktop application designed to work with your brain, not against it. Built with Tauri, React, TypeScript, and powered by Google Gemini AI.

Standard calendars assume you have linear energy, perfect memory, and a constant ability to initiate tasks. Mayzyyy Command assumes the opposite: that energy fluctuates, focus is precious, transitions are hard, and sometimes you just need a little digital dopamine.


🧠 The ADHD Productivity Paradox (How Mayzyyy Helps)

Standard calendars often fail people with ADHD because they treat all hours and tasks as equal. Here is how Mayzyyy makes daily life easier and solves common ADHD struggles:

ADHD Daily Problem standard Calendar Response Mayzyyy Command Solution
Executive Dysfunction & Task Paralysis Shows a giant, scary task that you keep avoiding, causing guilt. ⚡ Task Fracturing: Splinters overwhelming tasks into 3 ridiculously easy, physical micro-steps via Gemini AI (e.g., "Just open the file" or "Stand up").
Time Blindness & Transition Resistance Schedules back-to-back meetings without travel or prep time. 🛡️ Meeting Armor: Automatically schedules a 15m Prep block before and a 15m Decompress block after meetings to ease mental transitions.
Interruption & Focus Recovery A distraction happens, and you forget what you were doing. ⚓ Drop an Anchor: A rapid hotkey (Ctrl + Shift + A) to log your current train of thought. A persistent banner keeps reminding you until you return.
Object Permanence (Achievements) You forget what you did all week, leading to anxiety during performance reviews. 🏆 The Hype File: Deleting or completing high-energy "Spicy" tasks automatically logs them in a secure ledger, which AI can turn into professional review bullets.
Tone Masking & Corporate Burnout Struggling to write professional, polite emails when frustrated. 💼 Corporate Translator: A quick hotkey (Ctrl + Shift + M) to dump your unfiltered thoughts and let AI translate them into polished, professional correspondence.
Energy Fluctuations Expects 100% capacity every day. 🔋 Energy Focus & Survival Mode: Filter schedules by energy profile (Spicy, Fidget, Dopamine). Low-energy mode hides all but one task and shows daily routine pills.

🚀 Key Features

1. 🔋 Adaptive Energy Views

Instead of categorization by project, organize by cognitive weight:

  • 🌶️ Spicy: High-concentration, difficult tasks, or meetings.
  • 🪀 Fidget: Low-friction routines, chores, and basic upkeep.
  • 🎮 Dopamine: Playtime, breaks, or rewarding projects.
  • Low Energy (Survival Mode): Reduces cognitive load instantly. Hides all non-essential cards, giving you exactly one primary task and quick routine pills (💧 Water, 💊 Meds, 🧘 Breathe, 🚶 Walk) to check off.

2. ⚡ AI-Powered Task Fracturing

When you're stuck on a task, don't ignore it. Click the Zap (⚡) icon to fracture it. The integrated Gemini model analyzes the task and breaks it down into three tiny, low-barrier physical steps, replacing the intimidating block with manageable milestones.

3. ⚓ Mental Anchor Banner (Ctrl + Shift + A)

Got distracted by a phone call or a coworker? Tap the hotkey, write a quick one-liner of what you were doing, and a fixed banner anchors your focus to your screen. When you return, the banner is there to guide you back without the mental overhead.

4. 🛡️ Protective Meeting Buffers

When scheduling meetings via the built-in AI companion, it won't just book a single block. It automatically builds a shield around the meeting:

  1. Prep Block (15 mins, Fidget energy)
  2. The Meeting (Spicy energy)
  3. Decompress Block (15 mins, Fidget energy)

5. 💼 Corporate Translator (Ctrl + Shift + M)

Dump your raw thoughts, frustration, or blunt comments into the translator. The AI will output a sanitized, polite, and completely safe-to-send corporate email or chat message.

6. 🏆 The Hype File & Performance Review Spin

Every time you complete or shred a "Spicy" task, it goes into your Hype File ledger. At the end of the quarter, click a button to let the career coach AI spin those achievements (and even your routine tasks) into professional, resume-ready accomplishments.

7. 🌌 Zen Flow Space

Escape from cluttered schedules. Enter Zen Mode to view a minimal dashboard with a clean circular second timer and a list of targets for the day. Completing targets triggers retro mechanical clack sounds and rewarding canvas confetti.


🛠️ Technology Stack


⌨️ Keyboard Shortcuts

Shortcut Action
Ctrl + Space Toggle AI Companion Panel
Ctrl + Shift + A Drop a Mental Anchor
Ctrl + Shift + M Open Corporate Translator

📦 Getting Started

Prerequisites

Make sure you have the following installed on your machine:

Installation

  1. Clone the Repository:

    git clone https://github.com/ayberkince/mayzyyy.git
    cd mayzyyy
  2. Install Dependencies:

    pnpm install
  3. Run in Development Mode: To launch the Vite development server and the Tauri desktop window:

    pnpm tauri dev
  4. Build the Production Package: To bundle the application into a standalone installer or executable:

    pnpm tauri build

Setting up the Gemini AI Features

  1. Launch the application.
  2. Click the AI Companion floating button in the bottom right corner (or press Ctrl + Space).
  3. Paste your free API key from the Google AI Studio.
  4. Your key is stored securely in your local environment (localStorage) and is never sent to any server other than the official Google Gemini API endpoints.

About

No description or website provided.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages