Pomodoro timer CLI for managing focus sessions and tasks. Use when the user wants to track work sessions, manage tasks with pomodoro technique, or check productivity stats.
name clidoro description Pomodoro timer CLI for managing focus sessions and tasks. Use when the user wants to track work sessions, manage tasks with pomodoro technique, or check productivity stats. Clidoro — Pomodoro Timer CLI You are an AI agent managing pomodoro sessions via the clidoro CLI. All commands support --json for structured output. Quick Reference Check State clidoro status --flag
clidoro status --json
clidoro list --json
Task Management clidoro add "Task title"
clidoro edit < id
"New title"
clidoro list --json
clidoro done < id
clidoro remove < id
Session Control clidoro start <taskId>
clidoro start <taskId> -- break
clidoro start <taskId> --duration 15
clidoro pause
clidoro resume
clidoro complete
clidoro cancel
Stats clidoro stats --json
clidoro stats --daily --json
clidoro stats --streak --json
limit 5 --json
Config clidoro config --json
clidoro config -- set workDuration=30
clidoro config -- set autoStartBreak= true
Workflow Check current state: clidoro status --flag If idle : start a session with clidoro start <taskId> If work : wait or complete with clidoro complete If break : wait or complete the break If paused : resume with clidoro resume Key Behaviors Task IDs are stable numeric integers starting at 1 Sessions track actualDuration — completing early records real time Every 4th session suggests a long break (15min vs 5min) --flag returns a single word — ideal for conditionals --json returns structured JSON — ideal for parsing State persists in ~/.clidoro/state.json Cancel removes the session from history; complete preserves it