Lib.rs

git-tellme: github notifications for the CLI

I want my own git notifications using the Github API without the browser.

For the moment I will return the data to the terminal. Maybe later I can put a frontend dunst style. The project is still a work in progress. This is a small program to subscribe to github user repositories, user profiles and manage all your notifications from the comfort of your terminal.

For the terminal fonts with ligatures like FiraCode are recommended.

Installation

First install rustup+cargo: https://rustup.rs/

From crates.io:

cargo install git-tellme

From the repository source:

git clone https://github.com/marcelarie/git-tellme
cd git-tellme
echo AUTH_TOKEN='token YOUR_TOKEN_HERE' > .env
cargo install
cargo build --release
PATH=$PATH:`{pwd}`/target/release/gtm

Main commands

To get your notifications on the desktop run gtm -f on the background with & or create a daemon. For the moment it just listens all the time for notifications, non stop. And they are persistent. On click the notification will be opened with xdg-open ( your default system browser ):

$ gtm -f &

Get your notifications on the CLI:

$ gtm # or gtm -n
┌─────────────────────────────────────────────────────────────┐
│ treesitter/highlighter.lua:145: end_col value outside range │
│ https://github.com/neovim/neovim/issues/12861               │
└─────────────────────────────────────────────────────────────┘
# click on the link to open the issue

Get your repositories:

$ gtm -r
┌──────────────────────────────────────────┐
│ git-tellme                               │
│ https://github.com/marcelarie/git-tellme │
└──────────────────────────────────────────┘

Get someone else repositories:

$ gtm -ru rylev
┌──────────────────────────────────────┐
│ const-utf16                          │
│ https://github.com/rylev/const-utf16 │
└──────────────────────────────────────┘
┌────────────────────────────────────┐
│ coreutils                          │
│ https://github.com/rylev/coreutils │
└────────────────────────────────────┘

Subscribe to someone repositories:

$ gtm -su marcelarie

Check you're subscription's

$ gtm -s
 ⭐ marcelarie
┌──────────────────────────────────────────┐
│ git-tellme                               │
│ https://github.com/marcelarie/git-tellme │
└──────────────────────────────────────────┘

Unsubscribe:

$ gtm -Unu microsoft

Get help:

$ gtm -h
git-tellme 0.1.7

USAGE:
    gtm [FLAGS] [OPTIONS]

FLAGS:
    -h, --help                 Prints help information
    -n, --get-notifications    Get Github user notifications
    -r, --repos                Get Github user repositories
    -s, --subscribe            Pass `-su` and the username you want to subscribe to
    -f, --system               Show notifications on the system
    -U, --unsubscribe          Pass `-Unu` and the username you want to unsubscribe to
    -V, --version              Prints version information

OPTIONS:
    -t, --token <github-token>    Pass `-t` and you're GitHub token from
                                  https://github.com/settings/tokens
    -u, --user <user>             Select specific user profile

Call on terminal startup

If you want to get your notifications when you open your terminal you can add git-tellme to you're ~/.bashrc, ~/.zshrc or ~/.config/fish/config.fish

echo 'gtm' >> ~/.bashrc

Before you start

1. First of all you will need a personal access token from github.

• How to do get one here, you only can see the token one time after its creation.

git-tellme uses the GitHub API so that token has to be accessible for the whole system. At the start git-tellme will ask for your token if it does not find it:

$ gtm
<WARNING>
    No GitHub token was found.
    To generate one go to: https://github.com/settings/tokens
    To save it use the --token or -t parameter:

gtm --token <YOUR_GITHUB_TOKEN>

For more information try --help

You just need to paste the token and done :)

Main Todos

• Ask for username and authentication token or password and write it on redis
• Get notifications from the user
• Draw dynamic boxes for the CLI
• Open issue on the browser when clicking on the issue id ( on CLI)
• Get user profile on the browser when clicking on the user.
• Same with repos.
• Create cronos to check for new repos from other users on sys notifications.
• Subscribe to user new repositories
• Notification Bell 🔔
• Work with FZF, FZY

Using

• GitHub API
• reqwest
• tokio