Gitter

A terminal dashboard for monitoring multiple Git repositories. Built with Python and Textual.

Gitter dashboard

Gitter shows the status, current release, and upcoming issues for all your configured repos at a glance — and lets you stage files and write commits without leaving the terminal.

Features

Multi-repo dashboard — see branch status, release version, and next-release issues for all projects in one view
Release notes — commits are parsed into tagged releases and issues, displayed as a Markdown panel
Git commit modal — type/issue/summary fields auto-filled from the branch name, with a staging view for reviewing changes before committing
Stage/unstage files — double-click files to stage or unstage; one-click stage all / unstage all
CLI interface — status and issues commands with Rich-formatted tables for use in scripts or pipelines
Auto-refresh — repos are polled every 90 seconds in the background

Requirements

Python 3.9+
Git installed and available on PATH

Installation

From PyPI (recommended)

python -m venv .venv
source .venv/bin/activate       # Windows: .venv\Scripts\activate
pip install gitterapp

Note: the PyPI package adds gitter and gitterapp to your PATH, so you can run it from either.

From Source:

git clone https://github.com/bobbyskinnerart/Gitter.git
cd Gitter
python -m venv .venv
source .venv/bin/activate       # Windows: .venv\Scripts\activate
pip install -r requirements.txt

Usage

TUI (interactive dashboard)

python main.py tui

CLI commands

python main.py status                   # Table of all projects with status and release info
python main.py issues                   # All issues grouped by project and release
python main.py issues -p <project>      # Filter by project name
python main.py issues -r <release>      # Filter by release tag
python main.py version                  # Print version

Key bindings (TUI)

Key	Action
`Ctrl+K`	Commit selected project
`Ctrl+A`	Add project
`Ctrl+E`	Edit selected project
`Ctrl+D`	Delete selected project
`Ctrl+R`	Toggle release notes panel
`Ctrl+L`	Toggle log panel
`Ctrl+Q`	Quit

Double-click a project row to edit it.

Configuration

Projects are stored in ~/.gitter as JSON. Add a repo via Ctrl+A in the TUI or by editing the file directly.

Each project entry supports:

Field	Description
`name`	Display name
`directory`	Absolute path to the git repo
`tagBranch`	Branch where release tags live (e.g. `main`)
`issuePrefixes`	Issue prefixes to detect in commit messages (e.g. `GIT`, `PROJ`)
`prPatterns`	PR number patterns (regex)
`groups`	Optional grouping labels
`favorite`	Mark as favorite

License

MIT — see LICENSE.md for details.

Metadata

Release files for gitterApp 0.1.35

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

Source distribution (sdist)

Source distribution for gitterApp 0.1.35
File	Size	Uploaded
gitterapp-0.1.35.tar.gz	42.0 kB	Apr 29, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for gitterApp 0.1.35
File	Interpreter	ABI	Platform	Reset
gitterapp-0.1.35-py3-none-any.whl 52.1 kB Apr 29, 2026	Python 3	none	any	Details

Total release size: 94.1 kB

Release files / gitterapp-0.1.35.tar.gz

Download URL	gitterapp-0.1.35.tar.gz
Size	42.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`0fab01fc652cccf49a245b1bd17fba56d5c9ac2a7f71a7c8bdf61472968d67f3`
BLAKE2b-256 checksum How to use checksums	`f394cb47d030ebee39c152358b77a531109dd4a83c57a7c3343b3ced11e236be`
Upload date	Apr 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/bobbyski/Gitter
Publishing commit: github.com/bobbyski/Gitter/tree/02c123dfe2030e200c7f8c4783e344629e93e75e

Workflow

Publishing configuration: github.com/bobbyski/Gitter/blob/02c123dfe2030e200c7f8c4783e344629e93e75e/.github/workflows/publish.yml
Publishing logs: github.com/bobbyski/Gitter/actions/runs/25087898470/attempts/1

Artifact

Subject: gitterapp-0.1.35.tar.gz
SHA-256 checksum: 0fab01fc652cccf49a245b1bd17fba56d5c9ac2a7f71a7c8bdf61472968d67f3 Verifying attestations

Release files / gitterapp-0.1.35-py3-none-any.whl

Download URL	gitterapp-0.1.35-py3-none-any.whl
Size	52.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`e17b461b8635ccec92e19880245bac6dcef98b137cae26fda4d9ca9bf4d99d9e`
BLAKE2b-256 checksum How to use checksums	`6793e439b7e081769cae59606d56197a5150a966be118d3b0711c9e52a4721f7`
Upload date	Apr 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/bobbyski/Gitter
Publishing commit: github.com/bobbyski/Gitter/tree/02c123dfe2030e200c7f8c4783e344629e93e75e

Workflow

Publishing configuration: github.com/bobbyski/Gitter/blob/02c123dfe2030e200c7f8c4783e344629e93e75e/.github/workflows/publish.yml
Publishing logs: github.com/bobbyski/Gitter/actions/runs/25087898470/attempts/1

Artifact

Subject: gitterapp-0.1.35-py3-none-any.whl
SHA-256 checksum: e17b461b8635ccec92e19880245bac6dcef98b137cae26fda4d9ca9bf4d99d9e Verifying attestations