Tag is a small utility to track working hours. Entries are stored in ~/.tag/tag.csv. The CSV is used to generate summary reports.
-
Ctrl-Command-Space is the hotkey that triggeres the task dialog, allowing quickly starting/modifying/finishing tasks.
-
Typing a string starts working on a task from the current time. If the string is prefixed with a timestamp, start is set to the prefixed timestamp:
- When typing
#a tag is created, a string can contain multiple tags and these are stored separately in the CSV-file.#in the UI will trigger completion on known tags:
- Entering an empty string will sign you at the current timestamp. If just a timestamp is entered, and no description string, you will be signed out at that timestamp:
- Right-clicking (or option-click) triggers a menu. Use this to quit Tag:
The CSV format is:
UTC start, UTC stop, tags, description
Each start timestamp must be greater than or equal to the previous stop timestamp. The last line can leave the stop timestamp blank to indicate an ongoing task. When the UI is used to complete or change a task, the stop is written.
Tag is a program that I wrote a long time ago. It was initially abandoned, without being released, as I didn't need, but work circumstances changed and now I'm working on resurrecting it. See https://tightloop.io/resurrection/index.html for a more in-depth story.