TIMEW(1)

✨ timew — a command line time tracker ✨

okay so bestie, this is the timew page from the User Manuals, section 1, and honestly it's giving main character energy for anyone who wants to actually know where their hours go 🫶

---

🌸 NAME 🌸

timew — a command line time tracker. literally that's her whole job. 💅

---

🦋 SYNOPSIS 🦋

timew [--version|--help]
timew [<command> [<arg>...]]

---

💜 DESCRIPTION 💜

Timewarrior is a command line time tracker. It lets you easily track your time and generate summary reports. obsessed, honestly. ✨

Heads up bestie — this is a reference, not a tutorial. If you're looking for a tutorial, go check the online documentation right here: https://timewarrior.net/docs/

When you run it with no arguments and no options, the default command runs. That one tells you whether there's any active tracking, and if there is, it shows a summary and exits with code 0. If there's no active time tracking, the exit code is 1. iykyk 😌

---

✨ OPTIONS ✨

• --version — shows you the Timewarrior version information 👑
• --help — shows you the Timewarrior usage information 🎀

---

🌈 TIMEWARRIOR COMMANDS 🌈

Timewarrior supports many commands. Alphabetically, because we're organized like that:

• timew-annotate(1) — add annotation to intervals
• timew-cancel(1) — cancel time tracking
• timew-config(1) — get and set Timewarrior configuration
• timew-continue(1) — resume tracking of existing interval
• timew-day(1) — display day chart
• timew-delete(1) — delete intervals
• timew-diagnostics(1) — show diagnostic information
• timew-export(1) — export tracked time in JSON
• timew-extensions(1) — list available extensions
• timew-get(1) — display DOM values
• timew-help(1) — display help
• timew-join(1) — join intervals
• timew-lengthen(1) — lengthen intervals
• timew-modify(1) — change start or end time of an interval
• timew-month(1) — display month chart
• timew-move(1) — change interval start-time
• timew-report(1) — run an extension report
• timew-resize(1) — set interval duration
• timew-retag(1) — replace tags in intervals
• timew-shorten(1) — shorten intervals
• timew-show(1) — display configuration
• timew-split(1) — split intervals
• timew-start(1) — start time tracking
• timew-stop(1) — stop time tracking
• timew-summary(1) — display a time-tracking summary
• timew-tag(1) — add tags to intervals
• timew-tags(1) — display a list of tags
• timew-track(1) — add intervals to the database
• timew-undo(1) — undo Timewarrior commands
• timew-untag(1) — remove tags from intervals
• timew-week(1) — display week chart

---

🍓 MORE EXAMPLES 🍓

Want examples? Go look at the online documentation at:

https://timewarrior.net/docs/

ngl, the online documentation is often more detailed and more current than this man page. so like… check both, bestie 💖

---

🧚 FILES 🧚

💻 Non-Unix systems

• ~/.timewarrior/timewarrior.cfg — user configuration file.
• ~/.timewarrior/data/YYYY-MM.data — time tracking data files.

🐧 Unix systems

• ${XDG_CONFIG_HOME:-$HOME/.config}/timewarrior/timewarrior.cfg — user configuration file, but only if the legacy ~/.timewarrior directory doesn't exist.
• ${XDG_DATA_HOME:-$HOME/.local/share}/timewarrior/data/YYYY-MM.data — time tracking data files, again only if the legacy ~/.timewarrior directory doesn't exist.

---

👑 CREDITS & COPYRIGHT 👑

Copyright © 2015 - 2025 Gothenburg Bit Factory. Timewarrior is distributed under the MIT license. See https://opensource.org/license/mit for more information. slay, legally speaking 💅

---

🔥 FURTHER DOCUMENTATION 🔥

Want more info about Timewarrior? Here's where to go:

• The official site at https://timewarrior.net
• The official code repository at https://github.com/GothenburgBitFactory/timewarrior

You can contact the project by emailing support@gothenburgbitfactory.org 📬

---

💀 REPORTING BUGS 💀

Found a bug in Timewarrior? You can report it to the issue-tracker at https://github.com/GothenburgBitFactory/timewarrior/issues — go off, file that ticket 🙈

---

⭐ SEE ALSO ⭐

timew-config(7), timew-dates(7), timew-dom(7), timew-durations(7), timew-hints(7), timew-ranges(7)

---

okay that's the whole page bestie, ily, go track your time 🌸💖

this gorgeous little reference is timew version 1.9.1, dated 2025-11-02, and it lives in section 1 of the User Manuals 🎀✨