devLap

Use gst for an Overview of Every Git State

go dev.to

gst

gst is a read-only Git status visualizer for people who want to understand the shape of a repository before they run Git commands.

Git beginners often struggle because the current state is split across several places:

  • commits and branches form a graph
  • local branches and remote tracking branches can point at different commits
  • the index and working tree can each contain different file changes

gst puts those pieces into one terminal dashboard. It does not push, pull checkout, commit, merge, rebase, or mutate the repository.

Install

go install github.com/lef237/gst/cmd/gst@latest
Enter fullscreen mode Exit fullscreen mode

For local development:

go run ./cmd/gst
Enter fullscreen mode Exit fullscreen mode

To build a local binary:

go build -o tmp/gst ./cmd/gst
Enter fullscreen mode Exit fullscreen mode

Release steps are documented in docs/release.md.

Usage

gst
gst --interval 1s
gst --once
gst --no-color
Enter fullscreen mode Exit fullscreen mode

By default, gst opens the interactive TUI. Use tab or the left/right arrow keys to move between views, click a tab label, 1-8 to jump directly…

Source: dev.to

arrow_back Back to Tutorials