ahmadawais

CLI Pomodoro timer for the terminal. Built for humans and AI agents.

15
1
100% credibility
Found Mar 18, 2026 at 15 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

Clidoro is a terminal Pomodoro timer that lets you manage tasks, run timed focus and break sessions interactively, track stats, and get notifications.

How It Works

1
๐Ÿ” Discover Clidoro

You hear about a fun tomato timer for your computer screen that helps you focus on work in short bursts.

2
๐Ÿš€ Open the Timer

Type a simple command and a colorful, easy screen appears right in your terminal with pomodoro magic ready to go.

3
๐Ÿ“ Add Your Tasks

Press a key to jot down what you want to accomplish today, like 'Write email' or 'Clean kitchen', and they show up neatly listed.

4
โฑ๏ธ Start Your First Focus Burst

Pick a task, hit enter, and watch the big countdown timer start with a satisfying progress bar filling up as you work.

5
๐Ÿ”” Finish and Take a Break

When time's up, you get a cheerful alert; choose to pause, stop early, or automatically start a short relaxing break.

6
See Your Progress
๐Ÿ“ฑ
Quick Commands

Use simple words like 'stats' or 'list' anytime for updates without the full screen.

๐ŸŽฎ
Stay Interactive

Keep using the pretty screen to add more tasks and jump right back into timing.

๐Ÿ† Feel Super Productive

End your day with a sense of accomplishment, knowing exactly how much you focused and ready for tomorrow.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 15 to 15 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is clidoro?

Clidoro is a TypeScript CLI Pomodoro timer that runs in your terminal, delivering a responsive TUI for task management and real-time countdowns with progress bars. It solves scattered productivity tracking by storing tasks, sessions, and stats locally, while offering CLI commands like `clidoro add "Write docs"`, `clidoro start 1`, and `clidoro stats --json` for scripting. Fire it up with `npx clidoro` for interactive mode or pipe JSON output to tools like GitHub Copilot agents.

Why is it gaining traction?

Unlike GUI apps, clidoro stays in your terminal with desktop notifications, sound alerts, and presets like "Long Work" for cli pomodoro arch, Linux, Ubuntu, or Windows setups. Agent-friendly flags like `status --flag` return single words (idle/work/break/paused), perfect for cli GitHub Actions or automation via GitHub packages. Custom durations, streaks, and hooks for session events make it scriptable without fluff.

Who should use this?

Terminal-first devs on cli pomodoro for Linux or Windows who juggle tasks during coding sprints. Remote workers pairing it with cli GitHub repo pushes or Copilot for focused sessions. Automation enthusiasts scripting pomodoros into GitHub workflows or daily rituals.

Verdict

Grab it if you live in the terminalโ€”solid docs and tests make the 15 stars and 1.0% credibility score forgivable for an early Apache-2.0 project. Maturity shows in cross-platform polish, but watch for edge cases in high-volume use.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.