Skip to main content
Travis-ci build information giterm is officially packaged at PyPI giterm can be found on PyPI official giterm development status giterm is released under BSD 2-Clause license Join the chat at https://gitter.im/timlegrand/giterm

Features

Giterm is a ncurses-based terminal GUI for Git. It brings information about the current status of your Git working copy right in your terminal, real-time.

It exposes in a single view:

  • local branches, and which branch you’re currently on

  • remote branches, and which branch the current local branch is tracking

  • commit history, and which commit you are currently working from

  • current changes

  • a diff view of the selected file in the changes list

Real-time!

Every change to the working copy (file edition/move or any Git command) updates the GUI instantly. You can work as usual, and keep a terminal open with giterm to get instant feedback on your actions.

screenshot of giterm interface

Installation

pip install giterm

Or even better:

pipx run giterm

If you don’t have pip installed yet:

curl -s https://bootstrap.pypa.io/get-pip.py | sudo python
pip install giterm

Usage

cd path/to/git/working/copy
giterm

Keymap

  • [tab]: Toggle panel

  • [shift + tab]: Reverse Toggle

  • [up]/[down]: Scroll line by line

  • [page up]/[page down]: Scroll screen by screen

  • [h]: Log history

  • [c]: Changes view

  • [s]: Staging area

  • [d]: Diff view

  • [b]: Branches

  • [r]: Remotes

  • [t]: Tags

  • [space]: Stage/unstage current file

  • [q]: Quit

Requirements

Giterm needs the git executable to be installed and available in the PATH of your system. Others dependencies should be automatically handled by pip.

Technical background

Giterm uses subprocesses to call Git shell-based commands, and parses their outputs to bring the relevant information to the user interface.

It also uses a watchdog to listen file changes in the current working directory.

License

This software is provided under the BSD 2-Clause License. Please read the LICENSE file for further information.

Contribute

See the CONTRIBUTING file for how to help out.

Many thanks for your support!

Metadata

Release files for giterm 0.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for giterm 0.7.0
File Size Uploaded Provenance
giterm-0.7.0.tar.gz 16.1 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for giterm 0.7.0
File Interpreter ABI Platform
giterm-0.7.0-py3-none-any.whl Python 3 none any Details

Total release size: 33.9 kB

Release files / giterm-0.7.0.tar.gz

Download URL giterm-0.7.0.tar.gz
Size 16.1 kB
Tags Source
SHA-256 checksum
How to use checksums
e976e07c545d517e0e2f010a73255b82053cf129d3bc2d74fda27f2a5743ea97
BLAKE2b-256 checksum
How to use checksums
b36cfce264a27d5fe08b7cb58759c283617e7545986e62540c99b49e1dfee127
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.10.6

Release files / giterm-0.7.0-py3-none-any.whl

Download URL giterm-0.7.0-py3-none-any.whl
Size 17.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ddc7c1b2a7458367cdf973b492b183b8393003a8e175b2beefe4f539b6cb82f5
BLAKE2b-256 checksum
How to use checksums
b31945cf5f30f262b39860394553dc7e53ae2af9d7b140bdc234c0b15a4c9039
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.10.6

Security for giterm 0.7.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page