When you repeatedly jump back and forth between these commands while working, you sometimes start thinking, “It would be nice if I could see all the information I want right now in one place.”

So I created gst, a CLI tool that lets you check the state of a Git repository at a glance.

• lef237/gst: Read-only Git status visualizer

Why I built it

I was teaching Git to an acquaintance who had just started programming, and they said things like:

I don’t really understand git status

It’s hard to remember so many different commands

I’ve heard of tools like lazygit, but I’m scared I might accidentally change the repository state

That made me think: why not build a tool that solves those problems?

That was the starting point for this project.

What You Can See

When you launch gst, you can view your current branch, differences from remote repositories, modified files, staged changes, working directory diffs, stashes, and the commit graph—all from your terminal.

Demo video

A picture is worth a thousand words, so we have also prepared a video demonstration.

Watching it will give you a better sense of how gst works in practice and why it can be useful.

https://youtu.be/EMO3DaNkqT0

Installation

There are two ways to install it.

If you use Go, run:

go install github.com/lef237/gst/cmd/gst@latest

It also supports Homebrew. You can install it with:

brew install lef237/tap/gst

Usage

Normally, run the following command inside a repository:

gst

If you want to display the information once and then exit, use --once:

gst --once

In the TUI, you can move between views using the Tab key and arrow keys.

Press r to reload, and q to quit.

Read-Only

gst is a tool for checking the state of a repository.

It does not perform operations that modify the repository state, such as push, pull, checkout, commit, merge, or rebase.

Even if you are not very familiar with Git, there is less risk of accidentally changing something, so I think it is easy to use as a tool for checking repository status.

Diff display

In Git, staged changes and unstaged changes in the working tree are managed separately.

In gst, changed files are displayed with markers such as INDEX, WORKTREE, NEW, and CONFLICT.

This makes it easier to understand which files are staged and which files still only have changes in the working tree.

In the diff view, you can switch between the working tree diff and the staged diff.

This is useful when you want to check what will be included in the next commit, or when you want to organize your changes before splitting them into separate commits.

Copying diffs

In the diff view, you can copy the current diff directly to the clipboard.

Press y to copy working directory diffs, and i to copy staged diffs.

Pressing a copies a patch that includes all changes from HEAD to the current working directory.

The copied content is in patch format, so it can be applied with git apply.

I think this is very useful!

Summary

gst is not a tool intended to replace Git operations.

Rather, it is a tool for checking “what state is this repository in right now?” before you perform an operation.

Please give it a try :)

https://github.com/lef237/gst