TIMEW-ANNOTATE(1)

💅 TIMEW-ANNOTATE — the timew-annotate page from the User Manuals set ✨

okay bestie, welcome to the glow-up era of your intervals 💖 this one's all about timew-annotate and honestly it ate.

---

🌸 NAME 🌸

timew-annotate — add an annotation to intervals 🎀

✨ SYNOPSIS ✨

timew annotate [<id>...] <annotation>

🦋 DESCRIPTION 🦋

so like, the annotate command is literally the one you call to slap an annotation onto an interval. that's it, that's the vibe 💅

and if you're sitting there like "bestie where do i even find the <id> and <annotation> of an interval??" — go check out the summary command, it shows you both 👑 iykyk.

🌈 EXAMPLES 🌈

💜 annotate a single interval

call the command with an id and the annotation, easy peasy:

$ timew annotate @2 'Lorem ipsum'
Annotated @2 with "Lorem ipsum"

🍓 remove an annotation

annotating an interval with an empty string removes the annotation — yes, deleting is just annotating with nothing, iconic:

$ timew annotate @1 ''
Removed annotation from @1

🧚 annotate multiple intervals

you can annotate multiple intervals with the same annotation all at once by specifying their ids — group-chat energy, one message to everyone:

$ timew annotate @2 @10 @23 'Lorem ipsum'
Annotated @1 with "Lorem ipsum"
Annotated @10 with "Lorem ipsum"
Annotated @23 with "Lorem ipsum"

(and yeah, the page really does show Annotated @1 there even though you passed @2 — that's verbatim what the manpage says, i'm just the messenger 🙈)

⭐ annotate the current open interval

if there's active time tracking happening, you can just omit the ID when you wanna annotate the current open interval. main character energy, no ID needed:

$ timew start foo
...
$ timew annotate bar
Annotated @1 with "bar"

the result? your current interval ends up with tag 'foo' and annotation 'bar' 🫶

💀 BUGS & LIMITATIONS 💀

heads up bestie, there are some quirks here, no cap.

the summary command truncates annotations longer than 15 characters 😭 so if you need to see the whole thing, use the export command or a custom report instead.

also — and this is the big one — right now the annotation command picks the last token from the command line and uses that as the annotation. so if you don't use quotes, like this:

$ timew annotate @1 lorem ipsum

then interval @1 ends up with only 'ipsum' as its annotation 💀 use quotes to avoid this, periodt.

🔥 SEE ALSO 🔥

• timew-export(1)
• timew-summary(1)
• timew-tag(1)

---

that's the whole page, bestie — timew version 1.9.1, dated 2025-11-02 🎀 go forth and annotate, you've got this 💖✨