Tock

tock Plugin

Powerful time tracking tool for the command line with headless report generation, CSV/JSON export, and productivity analysis including Deep Work Score and Chronotype estimation.

Commands

Activity Tracking

• tock activity start — Start tracking time for an activity
• tock activity stop — Stop the current activity
• tock activity continue — Continue a previous activity
• tock activity current — Show the currently running activity
• tock activity last — List recent activities

Reporting

• tock report generate — Generate a text report for a specific day
• tock report export — Export report data as text, CSV, or JSON
• tock report analyze — Generate productivity analysis with Deep Work Score

Utility

• tock self version — Print tock version
• tock _ _ — Passthrough to tock CLI

Usage Examples

• "Start tracking work on Project X"
• "Generate a time report for today"
• "Export yesterday's report as CSV"
• "Analyze my productivity for the last 7 days"
• "Show my current activity"

Installation

brew install kriuchkov/tap/tock

Examples

# Start tracking
tock activity start "My Project" "Implementing features"
tock activity start -p "My Project" -d "Implementing features"

# Start with specific time and tags
tock activity start -p "My Project" -d "Meeting" -t 14:30 --note "Sprint planning" --tag "work"

# Stop tracking
tock activity stop
tock activity stop -t 17:00 --note "Finished for the day"

# Continue previous activity
tock activity continue
tock activity continue 1

# Show current activity
tock activity current
tock activity current --format "{{.Project}}: {{.Duration}}"

# List recent activities
tock activity last
tock activity last -n 20

# Generate reports
tock report generate --today
tock report generate --yesterday
tock report generate --date 2025-12-01
tock report generate -p "My Project" -d "meeting"
tock report generate --summary
tock report generate --json

# Export reports
tock report export --today
tock report export --yesterday --fmt csv
tock report export --date 2026-01-29 --fmt json
tock report export --today --stdout

# Productivity analysis
tock report analyze
tock report analyze --days 7

Key Features

• Simple CLI time tracking (start/stop/continue)
• Headless text reports with project/description filters
• JSON and CSV export with stdout option
• Productivity analysis (Deep Work Score, Chronotype, Context Switching)
• Calendar and iCal integration
• Shell completion support
• TodoTXT and TimeWarrior storage backends
• Custom themes and time formats