Skip to content

steffakasid/govital

Repository files navigation

Govital - Go Dependency Maintenance Scanner

License Apache%202.0 blue link:https://github.com/steffakasid/govital/actions/workflows/codeql-analysis.yml link:https://github.com/steffakasid/govital/actions/workflows/release.yml link:https://github.com/steffakasid/govital/actions/workflows/go-test.yml

A command-line tool to scan all dependencies of a given Go project and check if those dependencies are actively maintained and if the used versions are up to date.

Features

  • Scans all dependencies of a Go project

  • Checks if dependencies are actively maintained

  • Identifies outdated dependency versions

  • Provides detailed dependency status report

Prerequisites

  • Go 1.24.5 or later

  • Git (for downloading dependencies)

Installation

Homebrew

Install via Homebrew tap:

brew tap steffakasid/homebrew-govital
brew install govital

Go Install

Install directly using Go:

go install github.com/steffakasid/govital@latest

From Source

Clone and build:

git clone https://github.com/steffakasid/govital.git
cd govital
go build -o govital ./cmd/govital

Usage

Basic Scan

Scan the current project:

govital scan

Scan a specific project:

govital scan --project-path /path/to/project

Set Stale Threshold

Configure when dependencies are considered inactive (default: 30 days):

govital scan --stale-threshold 180

Include Indirect Dependencies

By default, only direct dependencies are scanned. To include indirect (transitive) dependencies:

govital scan --include-indirect

This is useful for analyzing the full dependency tree but can be slower for large projects.

Parallel Scanning

Control the number of parallel workers for faster scanning (default: 4):

# Use 8 workers for faster scanning on powerful hardware
govital scan --workers 8

# Use 1 worker to minimize resource usage
govital scan --workers 1

Parallel scanning significantly improves performance on projects with many dependencies.

Log Levels

Set log level for output:

govital scan --log-level debug

Available levels: debug, info, warn, error

Configuration

Extension points for the future

  • Scan multiple projects e.g. from Github organization or Gitlab group

  • Build Docker images with Govital pre-installed for CI/CD integration

  • Expose results as Prometheus metrics for monitoring

License

Apache License 2.0

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages