Skip to content

leereilly/gh-firehose

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

gh-firehose

A terminal-based visualization of real-time GitHub push events displayed on a rotating ASCII globe.

Built using GitHub Copilot CLI for the GitHub Copilot CLI Challenge.

Go

Features

  • 🌍 Animated rotating ASCII globe with accurate Earth landmass rendering
  • 📡 Real-time GitHub push event streaming
  • 🎨 Colored display (green land, blue ocean)
  • ✨ Smooth fade transitions for event messages

Installation

This is a GitHub CLI extension. Install it with:

gh extension install leereilly/gh-firehose

Alternatively, install with Go:

go install github.com/leereilly/gh-firehose@latest

Or build from source:

git clone https://github.com/leereilly/gh-firehose.git
cd gh-firehose
go build

Usage

gh firehose

Press q, Esc, or Ctrl+C to quit.

Requirements

  • Go 1.25+
  • Optional: GitHub CLI (gh) for authenticated API access (higher rate limits)

How It Works

The application fetches push events from the GitHub Events API and displays them as messages below a rotating ASCII globe. The globe uses an equirectangular projection bitmap to accurately render Earth's continents.

License

MIT

About

A terminal-based visualization of real-time GitHub push events displayed on a rotating ASCII globe.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages