Hey! An Interruption Tracker for Mac users

Usage

Record an event

hey <names>

<names> is a space separated list of one or more people’s names.

Note: all names are downcased in the database to save worrying about multiple entries when you accidentally type “bob” one time and “Bob” the next.

Tag an event

hey tag <event id> <tags>
hey retag <event id> <tags>

<event id> is usually last (to tag the most recent event) but if you need to tag a different one that was shown by hey list or hey data you can enter its id.

<tags> is a space separated list of tags to associated with this event.

If you tag the same event twice then the new tags will be appended to the list.

If you retag an event the new list will replace the old one

Record an event and tag it at the same time

Most of the time you create an event as it happens, and you don't know what it's going to be about yet, so you create it, then tag it later. But sometimes you create it just after it happened and you do know what it was about.

hey <names> +tag <tags>

<names> is a space separated list of one or more people's names.

<tags> is a space separated list of tags to associated with this event.

Viewing recent events

hey list

Recent interrupts: Chronological order
Starting at midnight yesterday. 

ID | Who       | When                 | Tags
2. | Bob, Mary | 4/12/17 14:23        | meeting, scheduled
3. | Bob       | 4/12/17 14:26        |
4. | Sam       | 4/12/17 16:11        | question 
5. | Mary      | 4/12/18 09:22        | task list

Reporting on recent events

hey graph will list all graphing options

hey graph people-by-hour

Collates your data, and loads it in a pretty graph on InterruptTracker.com for you. You can see an example here

Comment on an event

hey comment <event id> <my comment string>

<event id> is one of the ids shown by hey list or hey data

<my comment string> is… your comment. Doesn’t have to be in quotes. Ends when you hit enter.

Note if you comment on the same event twice it will replace the existing comment with your new one.

Delete accidental interrupts

hey delete <event id>

<event id> is one of the ids shown by hey list or hey data

Permanently deletes the specified record. There is no undo.

Delete accidental people

hey kill <name>

(Note: No humans will be harmed in the execution of this command.)

Deletes that person from your database, and removes them from any events. If there are events that only involved that person, they will also be deleted.

Exporting Data

NOT IMPLEMENTED

hey data

To be determined. YAML? TOML? JSON?

Whatever format it is should be something that other command line tools can ingest easily. Additionally we may want a simple query language or something similar to allow you to export just the data for a specific person, or date range.