While struggling with concentration, I’ve always forced myself to use techniques that help me stay in flow while still leaving room to stretch, grab some snacks, or prepare a matcha latte. Giving the brain time to stray away from a problem often helps to solve it in the ‘background.’

Nothing fits this better than the Pomodoro Technique. I used to use browser-based tools, but as my workflow shifted more toward the IDE and CLI (especially when ‘vibecoding’ with AI), I found myself forgetting to check the browser. I needed something fast, simple, and right in my terminal.

What’s your focus setup?
Do you prefer browser-based timers, or are you a terminal purist like me? Also, if you have a favorite CLI productivity tool, drop it in the comments—I’m always looking to improve my workflow!

Getting Started

1. Run npm i -g doro-cli (Requires Node.js)
2. Run the doro command to start.

Please check out the repository! I’d love to hear your feedback or see your contributions.

dnim
/
doro-cli

cli pomodoro timer for vibecoding

doro-cli

A minimal, keyboard-first, full-screen terminal Pomodoro timer with soft pastel themes and synthetic 8-bit audio cues.

Focus on your work, not your timer.

Features

• Distraction-Free UI: Full-screen, minimalist design keeps you focused.
• Keyboard-First: Navigate and control everything from your keyboard.
• Responsive Layout: Adapts to any terminal size, from tiny to wide.
• Color Themes: Switch between modern and calm themes with a keypress.
• Audio Cues: Lightweight, generated 8-bit sounds for timer events (no media files needed).
• Mouse Support: Optional mouse control for key actions.

Gallery

Small	Medium (Text Hints)	Medium (Icon Hints)	Wide

Installation

Requires Node.js >= 22.

npm install -g doro-cli

Once installed, just run doro in your terminal!

Quick Start (Build from source)

# Clone the repository
git clone https://github.com/dnim/doro-cli.git
cd doro-cli

# Install dependencies
npm install

# Build the project
npm run build

# Run it!
node dist/cli.js

Development

Run in…

View on GitHub

What’s your focus setup?

Do you prefer browser-based timers, or are you a terminal purist like me? Also, if you have a favorite CLI productivity tool, drop it in the comments – whould be happy to try!

See other CLI Pomodoro alternatives

• openpomodoro-cli – Built in Go, has a slightly different philosophy.

• pomo – A bit more minimal; requires cloning the repo to set up.