# samg/timetrap

Simple command line timetracker

Repository: https://github.com/samg/timetrap
Canonical: https://ross.abutalabs.com/products/timetrap
Homepage: http://rubygems.org/gems/timetrap
Language: Ruby
License: NOASSERTION
License Family: other
Last push: 2025-03-12T20:07:55+00:00

## Health v2 (maintenance only)
Score: 37/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 11, release rhythm 35, longevity 100
- inputs: {"age_days": 6351, "days_push": 539, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1512, forks 115 (observed 2026-08-28T04:04:56.003852+00:00)

## What it is
Timetrap is a simple command line time tracker written in Ruby, distributed as a gem that installs a `t` executable. It manages timesheets with check-in/check-out entries, notes, editing, and duration reports.

## Use cases
- track time spent on tasks from the terminal
- manage multiple timesheets for different projects
- log check-in and check-out entries with notes
- generate daily duration reports for billable hours
- edit or correct past time entries

## When to choose
- you want lightweight, keyboard-driven time tracking without a GUI
- you live in the terminal and want a fast `t in` / `t out` workflow
- you need simple text-based timesheet reports

## When to avoid
- you need graphical dashboards, invoicing, or team features
- you prefer web or mobile time tracking apps
- you're not comfortable installing Ruby gems

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: cli, developer-tools, scheduling
- domain: developer-tools
- platform: cli, cross-platform, ruby
- tags: time-tracking, timesheets, ruby-gem, productivity, command-line

## Member repositories
- samg/timetrap (main) score 37

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:56.003852+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-30T04:32:20.959183+00:00, confidence not recorded.
  - readme: https://github.com/samg/timetrap (fetched 2026-08-28T04:04:56.003852+00:00, sha 6da175b5c6ae)
  - homepage: http://rubygems.org/gems/timetrap (fetched 2026-08-29T11:36:14.320117+00:00, sha f0b701e081f3)
  - site_page: https://guides.rubygems.org/command-reference (fetched 2026-08-29T11:36:14.329394+00:00, sha ef62154d6253)
  - site_page: https://rubygems.org/pages/about (fetched 2026-08-29T11:36:14.332808+00:00, sha e4248571fa5d)
- Data as of 2026-08-30T08:39:29.467469+00:00.