TIMEW-GET(1)

🌸 TIMEW-GET(1) 🌸

okay so bestie, this is timew-get from the User Manuals β€” it's the little command that displays DOM values and honestly it's giving "quiet achiever" πŸ’…


✨ SYNOPSIS ✨

timew get <DOM>...

like, you just hand it one or more DOM refs and it does the thing 🫢


πŸ’– DESCRIPTION πŸ’–

So here's the vibe: it validates the DOM reference first, and then it goes and obtains the value and displays it. Validate-then-fetch, main character energy ⭐

If your reference is invalid? It's not gonna be subtle about it β€” an error message goes straight to stderr and the exit code is 1. No cap. πŸ’€

Every single DOM reference starts with dom, and there are 4 subreferences you can access:

  • dom.tracked β€” all the intervals πŸ“š
  • dom.active β€” active time tracking ⏱️
  • dom.tags β€” all the tags 🏷️
  • dom.rc β€” configuration settings βš™οΈ

For the deets on those, go see timew-config(7). And heads up: it is an error to reference an interval or tag that does not exist. Like, it does not exist, so it cannot help you, so it's a whole error. periodt πŸ™ˆ

Oh and this part's cute: if you give it more than one valid DOM reference, the results are concatenated by a space. πŸŽ€


πŸ¦‹ EXAMPLES πŸ¦‹

🌈 Query current time tracking

$ timew get dom.active 1

This query returns 1 if time tracking is active, and 0 if it's not. Binary queen πŸ‘‘

🌸 Display the 3rd interval of a query as JSON

For the dom.tracked reference, filtering by range and tags can be applied:

$ timew get dom.tracked.3.json :month FOO
{"id":42,"start":"20250802T101224Z","end":"20250802T101224Z","tags":["FOO","BAR"]}
⚠️ okay important: that 3 in the reference refers to the 3rd interval in the query result, NOT the interval with ID 3! 😭 Do not confuse them, bestie, I'm begging.

🧚 SEE ALSO 🧚

timew-dom(7)


and that's the whole page, mwah πŸ’œ β€” this was timew 1.9.1, dated 2025-11-02, from TIMEW-GET(1). slay, go query some DOMs πŸ¦‹βœ¨

πŸ“¦ where this page comes from