Ruby-lang clone of https://github.com/masukomi/hey

Track who/what/why/when you get interrupted.

You will need Ruby and SQLite to use hey-rb:

• https://www.ruby-lang.org/
• https://www.sqlite.org/

Install Ruby and SQLite if you haven't done so already. Homebrew is recommended for Mac users:

brew install sqlite

Add hey.rb to your path, for example:

cp hey.rb /usr/local/bin/hey

Optionally, add hey.bc to your local bash_completion.d directory:

cp hey.bc /usr/local/etc/bash_completion.d/hey
. /usr/local/etc/bash_completion.d/hey

By default, hey stores a SQLite database at ~/interrups.db. You can override the database location by setting the environment variable INTERRUPT_TRACKER_DB.

<> brackets indicate a required argument.

[] brackets indicate an optional argument.

hey <name> [optional reason string]

Normalizes the name string by converting to lowercase and stripping leading and trailing whitespace. Sets the start_time field to CURRENT_TIMESTAMP.

hey list

Lists all events in chronological order.

hey reason [-event_id] [optional reason string]

Overwrites the original reason (if any); clears the existing reason if no reason is provided and an event_id is specified.

If the first argument is -# then the corresponding event will be updated, otherwise the most recent event will be updated.

hey end

Sets the most recent event's end_time to CURRENT_TIMESTAMP if and only if the current end_time is null.

hey rename <old_name> <new_name> [event_id]

Changes the name field of all events where name = <old_name>.

If event_id is specified then only the record corresponding to the id is updated and only if the name field is equal to the <old_name>.

hey delete <event_id>

Permanently deletes the record where event_id = <event_id>.

hey kill <name>

Permanently deletes all events where name = <name>.

hey report <report_type>