Installation

gitlab-summary can be installed in multiple ways depending on your needs and environment.

Prerequisites

Before installing, ensure you have:

  • GitLab Access — A GitLab instance you can access
  • Access Token — Personal or Group Access Token with read_api scope
  • .NET 10 SDK — Only required if building from source

The easiest way to install gitlab-summary is as a .NET global tool.

Install 

  dotnet tool install -g GitLabSummary

Update

To update to the latest version:

  dotnet tool update -g GitLabSummary

Verify Installation 

  gitlab-summary --version

Uninstall 

  dotnet tool uninstall -g GitLabSummary

Option 2: Self-Contained Executables

Download pre-built executables from the Releases page. No .NET installation required.

Windows (x64) 

  # Download
curl -L -o gitlab-summary.exe https://github.com/garrardkitchen/gitlab-summary/releases/latest/download/gitlab-summary-win-x64.exe

# Run
./gitlab-summary.exe --version

macOS (Apple Silicon ARM64) 

  # Download
curl -L -o gitlab-summary https://github.com/garrardkitchen/gitlab-summary/releases/latest/download/gitlab-summary-osx-arm64

# Make executable
chmod +x gitlab-summary

# Run
./gitlab-summary --version

macOS (Intel x64) 

  # Download
curl -L -o gitlab-summary https://github.com/garrardkitchen/gitlab-summary/releases/latest/download/gitlab-summary-osx-x64

# Make executable
chmod +x gitlab-summary

# Run
./gitlab-summary --version

Linux (x64) 

  # Download
curl -L -o gitlab-summary https://github.com/garrardkitchen/gitlab-summary/releases/latest/download/gitlab-summary-linux-x64

# Make executable
chmod +x gitlab-summary

# Run
./gitlab-summary --version

Tip: Move the executable to a directory in your PATH:

  # macOS/Linux
sudo mv gitlab-summary /usr/local/bin/

# Verify
gitlab-summary --version

Option 3: Build from Source

Build from source if you want the latest development version or need to customize the build.

Clone Repository 

  git clone https://github.com/garrardkitchen/gitlab-summary.git
cd gitlab-summary

Build Dashboard 

  cd src/dashboard
npm install
npm run build

Build CLI 

  cd ../cli
dotnet build

Run 

  dotnet run --project src/cli/GitLabSummary -- --version

Optional: Create Alias

Add to your shell profile (~/.bashrc, ~/.zshrc, etc.):

  alias gitlab-summary='dotnet run --project ~/path/to/gitlab-summary/src/cli/GitLabSummary --'

Verify Installation

After installation, verify everything works:

  # Check version
gitlab-summary --version

# View help
gitlab-summary --help

Expected output:

  gitlab-summary v1.0.0

System Requirements

Minimum Requirements

  • OS: Windows 10+, macOS 11+, or modern Linux
  • RAM: 256 MB
  • Disk: 100 MB for installation

For Dashboard Development

  • Node.js: 18.x or later
  • npm: 9.x or later
  • Browser: Modern browser with ES2020 support

Troubleshooting

“Command not found” after global tool install

The .NET tools directory may not be in your PATH.

Solution:

  # macOS/Linux
export PATH="$PATH:$HOME/.dotnet/tools"

# Add to ~/.bashrc or ~/.zshrc to persist
echo 'export PATH="$PATH:$HOME/.dotnet/tools"' >> ~/.zshrc
  
  # Windows PowerShell
$env:PATH += ";$env:USERPROFILE\.dotnet\tools"

# Add permanently via System Environment Variables

“Permission denied” on macOS/Linux executables

Solution:

  chmod +x gitlab-summary

Executable won’t run on macOS (security warning)

Solution:

  # Remove quarantine attribute
xattr -d com.apple.quarantine gitlab-summary

# Or use System Preferences → Security & Privacy → Allow

.NET SDK not found (building from source)

Solution:

Download and install .NET 10 SDK from https://dotnet.microsoft.com/download

Next Steps

Updating gitlab-summary

Global Tool 

  dotnet tool update -g GitLabSummary

Self-Contained Executable

Download the latest release and replace your existing executable.

From Source 

  cd gitlab-summary
git pull origin main
cd src/dashboard && npm install && npm run build
cd ../cli && dotnet build

See Also