Gitlab TUI 🚀

A TUI app for interacting with GitLab issues and merge requests.

Installation ⚙️

Cargo 📦

You can use Cargo to download, compile, and install Gitlab TUI on your machine:

cargo install gitlab-tui

Setup 🛠️

To authenticate the GitLab API, Gitlab TUI uses the same .netrc config that Git uses for HTTP cloning. If you have already set up Git with .netrc, there is a good chance it will work immediately. If not, you will need to create one:

1. Create an API token in GitLab with read-api scope.

2. Create a .netrc file:

   • On Linux and macOS:

     touch ~/.netrc

   • On Windows:

     New-Item ~/.netrc

3. Create an entry for your GitLab instance:

   • For GitLab.com:

     machine gitlab.com
       login __token__
       password <YOUR_TOKEN>
     

   • For self-hosted GitLab:

     machine <YOUR_GITLAB_INSTANCE>
       login __token__
       password <YOUR_TOKEN>
     

That's it! Now just cd into your repo and run gitlab-tui. The program will parse your Git SSH or HTTP remote to figure out the GitLab API URL and fetch all issues and merge requests of your project.

Usage 🚀

The binary is called gitlab-tui. You can bring up the UI by running it without any arguments. If you need to use a different remote than origin, you can use the -r flag to override the remote.