// 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. |
You are an AI agent managing pomodoro sessions via the clidoro CLI. All commands support --json for structured output.
clidoro status --flag # → idle | work | break | paused
clidoro status --json # Full session details
clidoro list --json # All tasks with pomodoro counts
clidoro add "Task title" # Returns task ID
clidoro edit <id> "New title" # Rename task
clidoro list --json # List all tasks
clidoro done <id> # Mark done
clidoro remove <id> # Delete task
clidoro start <taskId> # Start 25min pomodoro
clidoro start <taskId> --break # Start break
clidoro start <taskId> --duration 15 # Custom minutes
clidoro pause # Pause session
clidoro resume # Resume session
clidoro complete # Complete early (records actual time)
clidoro cancel # Cancel without recording
clidoro stats --json # Full stats
clidoro stats --daily --json # Today
clidoro stats --streak --json # Current streak
clidoro history --limit 5 --json # Recent sessions
clidoro config --json # View config
clidoro config --set workDuration=30 # 30min work
clidoro config --set autoStartBreak=true # Auto break
clidoro status --flagidle: start a session with clidoro start <taskId>work: wait or complete with clidoro completebreak: wait or complete the breakpaused: resume with clidoro resumeactualDuration — completing early records real time--flag returns a single word — ideal for conditionals--json returns structured JSON — ideal for parsing~/.clidoro/state.json