clockin

A simple, colorful terminal time tracker. Clock in when you start, clock out when you stop. Tag sessions, view weekly/monthly summaries, and export to CSV.

--- COMMANDS

• clockin start "Task"
• clockin start "Task" --tag work
• clockin stop
• clockin status
• clockin log
• clockin log --date today
• clockin log --date yesterday
• clockin log --tag work
• clockin summary week
• clockin summary month
• clockin export | Export all sessions to CSV
• clockin delete <id> | Delete a session by ID

--- BACKGROUND USAGE

Use standard Linux tools to run in the background:

• nohup clockin start "Task" &
• clockin start "Task" & disown
• systemd-run --user clockin start "Task"

Then check progress or stop from any terminal:

• clockin status
• clockin stop

--- DATA & PRIVACY

All sessions are stored locally in ~/.clockin/sessions.json.
No telemetry, no cloud sync, no accounts required.

Source code: https://github.com/anuragbhattacharjee/clockin