| 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
clidoro history --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