pomux

A cyberpunk-themed Pomodoro timer for your terminal.

╔══════════════════════════════════╗
║   ███╗   ███╗██╗███╗   ██╗██╗    ║
║   ████╗ ████║██║████╗  ██║██║    ║
║   ██╔████╔██║██║██╔██╗ ██║██║    ║
║   ██║╚██╔╝██║██║██║╚██╗██║██║    ║
║   ██║ ╚═╝ ██║██║██║ ╚████║██║    ║
║   ╚═╝     ╚═╝╚═╝╚═╝  ╚═══╝╚═╝    ║
╠══════════════════════════════════╣
║                                  ║
║      ⫸ Working on Project X ⫷   ║
║                                  ║
║         ⠹ 00:25:00 ⠹            ║
║          FOCUS                   ║
║   ████████░░░░░░░░░░░░░░░░░░░    ║
║                                  ║
║   Session 1    ● ○ ○ ○           ║
║                                  ║
║   [Space] Start  [R] Reset       ║
║   [S] Skip  [N] Name  [Q] Quit   ║
╚══════════════════════════════════╝

Features

• Cyberpunk aesthetic — neon cyan, pink, and amber colors with bold borders
• Animated spinner — braille spinner indicates active timer
• Progress bar — visual progress for each session
• Session tracking — cycle dots show progress through 4-session sets
• Session history — log of completed focus and break sessions
• Activity name — label your work session via CLI arg or in-app
• Keyboard-driven — simple, vim-friendly controls

Install

npm install -g pomux

Usage

# Start with an activity name
pomux "Working on Project X"

# Start without a name
pomux

Controls

| Key | Action | | --- | --- | | Space | Start / Pause / Resume | | R | Reset current session | | S | Skip to next phase | | N | Edit activity name | | Q | Quit |

When editing the activity name, type to enter text, Enter to confirm, Escape to cancel, and Backspace to delete.

Pomodoro Cycle

idle → focus (25m) → short break (5m) → focus → ... → long break (15m)
                                                ↑
                                     after 4 focus sessions

1. Focus — 25 minutes, neon cyan
2. Short Break — 5 minutes, neon pink
3. Repeat steps 1–2 three more times
4. Long Break — 15 minutes, amber
5. Start over

The border color changes to match the current phase.

License

MIT