Taskwarrior integration for Github notifications

This is a simple python package that integrates Taskwarrior with Github notifications. It uses the Github API to fetch notifications and creates a task for each one of them.

For more information about the gh api, please refer to the official documentation.

Installation

pip

$ git clone https://github.com/Jimmy2027/gh_taskw.git
$ cd gh_taskw
$ pip install .

Portage

The package is made available in a portage overlay.

root@host $ emerge gh_taskw

Dependencies

Github CLI needs to be installed and configured.

gh_taskw can be configered to use tasknote. If you choose to use tasknote, you will need to install it and configure it.

Example Configuration

The configuation file is located at ~/.config/gh_taskw.toml.

# ~/.config/gh_taskw.toml
tasknote_config = "~/.config/tasknote.toml" # Use tasknote

# ignore notifications from ci runs for example
ignore_notification_reasons = ["ci_activity"]

Usage

As a cron job

* * * * * /usr/bin/gh_taskw

As a tmux session

#!/bin/bash

session="gh_taskw"

tmux new-session -d -s $session

window=1
tmux send-keys -t $session:$window 'watch -n 60 gh_taskw' C-m