gith

Gith (Catppuccin Theme)

A TUI git helper with catppuccin theme written in Go

[!WARNING] Still in development

For the terminal customization / starship config, check out my ubuntu customization blog article.
This is the full setup, for only starship scroll down to the starship section.

Installation

[!NOTE] If you don't have Go installed, check out the gith project page, Go installation is included there.

Install directly using Go

go install github.com/a3chron/gith@latest

What is and what will work

• Branch

  • Switch Branch (supports checking out remote branches locally)

  • List Branches

  • Delete Branch (with fallback to force delete)

  • Create Branch

• Status

  • View working tree status (Modified, Added, Deleted, Untracked files)

• Commit

  • Undo Last Commit

  • Commit staged changes

  • Commit all changes

  • Amend last commit

• Tag

  • List Tags (shows 10 latest)

  • Remove Tag (from a list of all local tags)

  • Push Tag (prompts to confirm pusing the latest tag)

  • Add Tag

• Remote

  • List Remotes

  • Add Remote

  • Remove Remote

  • Update Remote url

  • Push to remote

  • Pull from remote

• Changes

  • View diff of changes

  • Stage/unstage individual files

• Options

  • Change UI flavor

  • Change UI accent color

Local Development

Build using:

go build -o gith

Then run with:

./gith

Customization

I will add a config file & customization options soon.
If you can't wait for the other catppuccin accents / flavors, you can clone the repo, and change everything you need in /internal/ui/styles.go.

built using BubbleTea, design heavily based on opencode

TODO

• add config file (accent & flavor)

• add init repo (&add remote?) with presets for some frameworks, gitignores etc -> move to seperate project gith-init

• get latest tag in utils version, in add tag show current latest tag

• add loading states when fetching sth

• prettier version (& help) output

• improve remove tag only show n latest tags wiht "pagination" instead of optional show all

• add confirmation for things like force branch delete