Harmonia Zen

An immersive, distraction-free coding environment for Visual Studio Code with customizable Zen Mode and integrated Pomodoro timer.

Why Harmonia Zen?

VS Code includes a built-in Zen Mode that hides UI elements for distraction-free coding. Harmonia Zen builds on this concept by giving you granular control over exactly what stays and what goes, paired with productivity tools to help structure your focus sessions.

What Harmonia Zen adds:

• Selective UI control - Choose exactly which 17 UI elements to show or hide, rather than an all-or-nothing approach
• Settings preservation - Your original settings are automatically saved and restored when toggling Zen Mode
• Preset profiles - Switch between different configurations instantly (Minimal, Writer, Focus, or your own custom presets)
• Integrated Pomodoro timer - Structure your work with timed focus sessions and breaks
• Focus statistics - Track your productivity with daily, weekly, and all-time metrics
• Visual feedback - See your progress with charts and streak tracking

Features

Zen Mode Panel

A sleek control panel where you configure your distraction-free environment. Toggle individual UI elements on or off to create your perfect workspace.

Controllable elements:

• Editor: Line Numbers, Gutter, Minimap, Breadcrumbs, Indent Guides, Bracket Pairs, Rulers
• Scrollbars: Vertical and Horizontal
• Workbench: Activity Bar, Status Bar, Side Bar, Panel, Tabs
• Behavior: Cursor Blinking, Render Whitespace, Line Highlight

Preset Profiles

Quickly switch between different configurations:

Pomodoro Timer

Structure your work with the Pomodoro Technique:

• Work sessions (default 25 minutes)
• Short breaks (default 5 minutes)
• Long breaks (default 15 minutes, after 4 sessions)
• Customizable durations
• Auto-start option for continuous flow
• Session counter to track completed pomodoros
• Status bar integration for quick access

Focus Statistics

Track your productivity journey with detailed statistics:

• Today's progress - Sessions and focus time
• Streak tracking - Current and longest streaks
• Weekly overview - Visual bar charts of your last 7 days
• All-time totals - Cumulative statistics
• Data stored locally (no cloud, no telemetry)

Installation

1. Open VS Code
2. Go to Extensions (Cmd+Shift+X / Ctrl+Shift+X)
3. Search for "Harmonia Zen"
4. Click Install

Usage

Quick Start

1. Open the Zen Mode Panel: Press Cmd+Alt+Shift+Z (Mac) or Ctrl+Alt+Shift+Z (Windows/Linux)
2. Toggle Zen Mode: Click the toggle switch or press Cmd+Alt+Z / Ctrl+Alt+Z
3. Customize: Adjust individual UI element toggles to your preference
4. Save a preset: Click "Save Custom Preset" to save your configuration

Pomodoro Timer

1. Start: Click the Start button or press Cmd+Alt+P / Ctrl+Alt+P
2. Pause/Resume: Click again or use the same shortcut
3. Stop: Press Cmd+Alt+S / Ctrl+Alt+S
4. Skip session: Press Cmd+Alt+N / Ctrl+Alt+N

The timer also appears in the status bar for quick access.

View Statistics

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run:

Harmonia Zen: Show Focus Statistics

Keyboard Shortcuts

Commands

All commands are available in the Command Palette under the "Harmonia Zen" category:

• Open Zen Mode Panel
• Toggle Zen Mode
• Start Pomodoro Timer
• Pause Pomodoro Timer
• Stop Pomodoro Timer
• Toggle Pomodoro Timer (Start/Pause)
• Reset Pomodoro Timer
• Skip Current Session
• Apply Preset
• Show Focus Statistics

Languages

Harmonia Zen supports:

• English (default)
• Spanish

The language is automatically detected from your VS Code settings.

Privacy

Harmonia Zen respects your privacy:

• No telemetry - Zero data collection or transmission
• Local storage only - All settings and statistics are stored locally
• No cloud sync - The extension does not communicate externally
• Transparent - You can see exactly what settings are changed

Contributing

Contributions are welcome! Please visit the GitHub repository to report issues or submit pull requests.

License

MIT License - see LICENSE for details.

Remember: The best productivity tool is one that disappears when in use. Focus on your work, not your tools.

Demo