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

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

cargo install gitlab-tui

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.

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.