mrglab is a TUI to manage merge requests
in Gitlab from the command line.
- Nerd Font (Symbols) v3.2.1 or higher download
go install github.com/felipeospina21/mrglab@latest
config file is read from ~/.config/mrglab/mrglab.toml
by default.
To access private repos, you will need to set an env variable with a gitlab personal access token. This can be set in your shell config file (to persist it) or in your terminal (for the session).
export MRGLAB_TOKEN="YOUR_GITLAB_TOKEN"
Option | Description | Default | Example |
---|---|---|---|
base_url | base api url | https://gitlab.com | |
filters.projects | list of project objects | [ { name="Gitlab Cli", id="34675721", fullPath="gitlab-org/cli" } ] |
project
is an object with a name
and id
properties.
name
-string
is rendered in the project list viewid
-string
is thegitlab project id
used to fetch selected projectmerge requests
&issues
fullPath
-string
is the url path to the project after the base_url
base_url = "https://gitlab.com"
[filters]
projects = [
{ name = "Gitlab Cli", id = "34675721", fullPath = "gitlab-org/cli" },
]
mrglab
The purpose of this project was to learn more about go
and bubbletea
. It is by no mean a full replacement of Gitlab UI (and it is not planned to be), but a complementary tool that would fit in some terminal workflows.
this project is inspired by tools like gh-dash.