dee-timer

Track focused work sessions and pomodoros locally with consistent JSON output.

Install

cargo install dee-timer

Quick start

dee-timer start "Write launch copy" --project launch
dee-timer status
dee-timer stop
dee-timer report --period week --json

Commands

• start [task] [--project <name>] [--tags tag1,tag2] [--notes <text>] [--pomodoro]
• stop
• status
• show <id>
• list [--status running|stopped|all] [--project <name>] [--limit <n>]
• report [--period today|week|month|all] [--project <name>]
• delete <id>

Agent-friendly output

Use --json with every command.

Success list:

{"ok":true,"count":2,"items":[...]}

Success item:

{"ok":true,"item":{"active":true,...}}

Success action:

{"ok":true,"message":"Session started","id":4}

Error:

{"ok":false,"error":"No active session found","code":"NO_ACTIVE_SESSION"}

Help

dee-timer --help
dee-timer <command> --help