https://github.com/moneycaringcoder/gitstream-tui
Live GitHub activity feed TUI — watch repo events in your terminal
https://github.com/moneycaringcoder/gitstream-tui
github go golang tools tui
Last synced: 3 months ago
JSON representation
Live GitHub activity feed TUI — watch repo events in your terminal
- Host: GitHub
- URL: https://github.com/moneycaringcoder/gitstream-tui
- Owner: moneycaringcoder
- License: mit
- Created: 2026-04-07T14:02:09.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-08T10:29:53.000Z (3 months ago)
- Last Synced: 2026-04-08T11:26:40.931Z (3 months ago)
- Topics: github, go, golang, tools, tui
- Language: Go
- Homepage:
- Size: 91.8 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# gitstream-tui
A lightweight terminal dashboard for watching GitHub repository activity in real-time. Built for developers running multiple agentic coding sessions who need a single pane of glass for what's happening across their repos.
## Features
- Live multi-repo activity feed (pushes, PRs, comments, reviews, CI, branches)
- Color-coded event types for quick scanning
- Configurable polling interval
- Minimal resource usage - single binary, no runtime dependencies
- Keyboard navigation and filtering
## Install
### Homebrew (macOS / Linux)
```bash
brew install moneycaringcoder/tap/gitstream
```
### Scoop (Windows)
```powershell
scoop bucket add moneycaringcoder https://github.com/moneycaringcoder/scoop-bucket
scoop install gitstream
```
### Go
```bash
go install github.com/moneycaringcoder/gitstream-tui/cmd/gitstream@latest
```
Requires Go 1.24+. The binary is installed to `$GOPATH/bin` (usually `~/go/bin`).
> **Note:** `go install` builds from source and does not embed version info. For automatic update checks to work correctly, use one of the other install methods or download a pre-built binary.
### Pre-built binaries
Download the latest release for your platform from [Releases](https://github.com/moneycaringcoder/gitstream-tui/releases). Extract and place the binary somewhere on your `PATH`.
## Updating
### Homebrew
```bash
brew upgrade gitstream
```
### Scoop
```powershell
scoop update gitstream
```
## Usage
```bash
# First run - creates config at ~/.config/gitstream/config.yaml
gitstream
# Add repos to watch
gitstream add owner/repo
# Start the feed
gitstream
```
## Configuration
Config lives at `~/.config/gitstream/config.yaml`:
```yaml
repos:
- owner/repo
- org/another-repo
interval: 30 # polling interval in seconds
```
## Requirements
- GitHub CLI (`gh`) installed and authenticated
## Built With
- [blit](https://github.com/blitui/blit) - TUI component toolkit
- [Bubble Tea](https://github.com/charmbracelet/bubbletea) - TUI framework
- [Lip Gloss](https://github.com/charmbracelet/lipgloss) - Styling
- GitHub REST API via `gh` CLI auth
## License
MIT