TIMEW-HINTS(7)

✨ TIMEW-HINTS ✨

okay so bestie, this is the TIMEW-HINTS(7) page from the User Manuals section β€” it's literally the whole tea on Timewarrior hints, and honestly? it's giving cheat sheet. 🫢

πŸ’« NAME πŸ’«

timew-hints β€” Timewarrior hints. that's it, that's the name, we love a short queen πŸ‘‘

🌸 SYNOPSIS 🌸

ok so there's genuinely nothing here 😭 no synopsis, no arguments, nothing β€” the section exists but it's empty. iconic of it tbh. moving on πŸ’…

πŸ¦‹ DESCRIPTION πŸ¦‹

right so β€” Timewarrior supports hints, and a hint is literally a single-word command line feature that starts with a colon. like so:

:week

Hints do a few different jobs, and this is the important part. that :week up there? it's a shortcut for the date range that defines the current week. one word, whole week. slay. ✨

then there's other hints, like:

:quiet

and those are the ways you control the behavior of Timewarrior β€” in this specific case :quiet eliminates all forms of feedback, which is exactly what you want for automation. no chatter, just vibes and output. 🧚

here's the full list of supported hints, no cap:

  • :quiet β€” turns off all feedback. for automation πŸ’€
  • :debug β€” runs in debug mode, shows many runtime details πŸ”
  • :yes β€” overrides confirmation by answering 'yes' to the questions
  • :color β€” forces color on, even if not connected to a TTY 🌈
  • :nocolor β€” forces color off, even if connected to a TTY
  • :blank β€” leaves tracked time out of a report
  • :fill β€” expands time to fill surrounding available gap
  • :adjust β€” automatically corrects overlaps
  • :ids β€” displays interval ID numbers in the summary report

πŸŽ€ Range hints πŸŽ€

ok now the range hints, which are convenient shortcuts to date ranges β€” this is the section you're gonna screenshot and send to your group chat, fr fr:

  • :all β€” all tracked time πŸ‘‘
  • :yesterday β€” the 24 hours of the previous day
  • :day / :today β€” the 24 hours of the current day ⭐
  • :week β€” this week
  • :fortnight β€” this week and the one before
  • :month β€” this month
  • :quarter β€” this quarter
  • :year β€” this year
  • :lastweek β€” last week
  • :lastmonth β€” last month
  • :lastquarter β€” last quarter
  • :lastyear β€” last year
  • :monday β€” previous monday
  • :tuesday β€” previous tuesday
  • :wednesday β€” previous wednesday
  • :thursday β€” previous thursday
  • :friday β€” previous friday
  • :saturday β€” previous saturday
  • :sunday β€” previous sunday πŸ¦‹

note the weekday ones all say previous β€” not "this coming", not "next", previous. lowkey important, don't @ me πŸ’…


and that's the whole page!! this dropped as part of timew 1.9.1, dated 2025-11-02 β€” so if you're out here hinting with an older build, vibe check your version first πŸ˜­πŸ’– go forth and :week responsibly, bestie 🫢✨

πŸ“¦ where this page comes from