# jazzband/Watson

:watch: A wonderful CLI to track your time!

Repository: https://github.com/jazzband/Watson
Canonical: https://ross.abutalabs.com/products/watson
Homepage: http://jazzband.github.io/Watson/
Language: Python
License: MIT
License Family: permissive
Topics: cli, project-management, time-tracker, timetracking
Last push: 2025-12-15T17:11:23+00:00

## Health v2 (maintenance only)
Score: 48/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 57, release rhythm 8, longevity 100
- inputs: {"age_days": 4187, "days_push": 261, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2537, forks 257 (observed 2026-08-28T04:06:59.264575+00:00)

## What it is
Watson is a command-line time tracker that lets you start and stop timers for projects and tags, recording work sessions as frames. It generates logs and reports from your tracked time, with optional syncing to a self-hosted server.

## Use cases
- track time spent on projects from the terminal
- generate client reports for billable hours
- log work sessions with project and tag filtering
- see how much time I spend on each task
- self-host time tracking data synced across machines

## When to choose
- you want fast, keyboard-driven time tracking without a GUI
- you prefer local-first data storage with optional self-hosted sync
- you need simple CLI reports filtered by project, tag, or date

## When to avoid
- you need a graphical dashboard or calendar-style time tracking
- you require team-wide timesheet approval workflows
- you want automatic time detection rather than manual start/stop

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, developer-tools, analytics
- domain: developer-tools
- platform: cli, cross-platform, python, windows
- tags: time-tracking, time-management, reporting, project-management, command-line, macos, linux

## Member repositories
- jazzband/Watson (main) score 48

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:59.264575+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:25:12.649226+00:00, confidence not recorded.
  - readme: https://github.com/jazzband/Watson (fetched 2026-08-28T04:06:59.264575+00:00, sha 417650e4c06b)
  - homepage: http://jazzband.github.io/Watson/ (fetched 2026-08-29T10:07:18.269556+00:00, sha cca95cd1c468)
- Data as of 2026-08-30T08:39:29.467469+00:00.