TIMEW-TRACK(1)

💜 TIMEW-TRACK(1) — the timew-track girlies' era

okay bestie, so this is the timew-track page from the timew manual set, and honestly? it's giving "backdated homework" in the best way 💅

---

✨ NAME ✨

timew-track — literally just add intervals to the database 🎀

---

🌸 SYNOPSIS 🌸

timew track <range> [<tag>...]

---

🦋 DESCRIPTION 🦋

The track command is your little time machine for adding tracked time in the past 🕰️✨. Like, maybe you forgot to record something (we've all been there, no judgment 🙈), or you're just filling in some old entries and making the timeline look cute. Either way, track has you 🫶

---

🎀 HINTS 🎀

So besides the range hints (those live over in timew-hints(7), go say hi to them 💖), the track command also accepts these hints:

• :fill — the :fill hint creates a brand new interval that fills the gap between two adjacent intervals 🧩✨ it's literally the "plug the hole" button, iykyk

---

🌈 EXAMPLES 🌈

⭐ Recording a closed interval

For example:

$ timew track :yesterday 'Training Course'
$ timew track 9am - 11am 'Staff Meeting'

important vibe check 🚨: the track command expects a closed interval (start time AND end time) when you're recording. If you don't give it a closed interval, track behaves exactly the same as the start command. so like, no end time = surprise start, bestie 😭

🍓 Filling the gap between two intervals

To fill the gap between two intervals without having to specify the exact times, you can use the :fill hint 💫. So when, for example, the first interval ends some time before 10:00 and the second interval starts some time after 11:00, calling

$ timew track 10:00 - 11:00 :fill 'Coffee Break'

will instruct Timewarrior to expand that interval so it starts right after the first interval and ends right before the second one 🔥 literally snapping into place like a puzzle piece, obsessed.

---

👑 SEE ALSO 👑

timew-cancel(1), timew-continue(1), timew-start(1), timew-stop(1)

---

and that's the whole page, bestie, you ate 💅✨ this little masterpiece is from timew 1.9.1, dated 2025-11-02 — screenshot it, cite it, frame it, it's iconic 🎀🫶