TIMEW-RETAG(1)

📦
version 1.9.1 · 7 versions
, in ubuntu resolute, ubuntu stonking

💅 TIMEW-RETAG(1) — the timew retag glow-up page ✨

okay so bestie, welcome to the retag manual — it lives in the User Manuals section of the Timewarrior docs, and it's honestly iconic. it's giving "out with the old tags, in with the new" 🎀

🌸 NAME 🌸

timew-retag — replace all tags in intervals, fr fr 💖

✨ SYNOPSIS ✨

timew retag [<id>...] <tag>...

that's it. that's the whole vibe check. <id>s are optional (sometimes 👀), and then you gotta give it at least one <tag>.

🦋 DESCRIPTION 🦋

okay so the retag command's whole personality is: it replaces every single tag in an interval with the shiny new tags you just handed it. not "adds", not "merges" — replaces. the old tags are gone, bestie, no cap 💀

wanna know which interval is which? here's the trick: use the summary command and pass the :ids hint, and it will literally show you interval IDs. 🌈 then you take the right ID, and boom — you've identified the interval you wanna retag. easy. slay. 👑

🔥 EXAMPLES 🔥

first up, show the IDs:

$ timew summary :week :ids

then, say you've picked @2 as the interval you wish to retag:

$ timew retag @2 'New Tag'

and yes, you can absolutely retag multiple intervals with multiple tags — main character energy honestly:

$ timew retag @2 @10 @23 'Tag One' tag2 tag3

now here's a cute lil detail: if there's active time tracking going on, you can just omit the ID when you want to retag the current open interval 🫶

$ timew start foo
$ timew retag bar

and the result? the current interval ends up having only the bar tag. that's it. that's the whole story. the foo tag said bye 🙈

ngl, remember the vibe here: retag = full replacement. if you wanted to keep the old tags, this ain't the command you're looking for, honey 💅

🎀 SEE ALSO 🎀

go read your sisters' pages too, they're all valid:

⭐ so yeah, that's the whole page! this lil masterpiece is from timew version 1.9.1, dated 2025-11-02 — go forth and retag responsibly, bestie 💜🧚🍓

📦 where this page comes from