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.