📊
Chronological Display
View all deployment runs sorted by time (newest first) in a clean, organized interface
🔄
Real-time Streaming
Auto-streams active workflow runs in real-time with status updates every 5 seconds
🔗
Clickable Links
Direct links to GitHub Actions pages - Ctrl/Cmd+Click to open in your browser
📈
Smart Updates
First run shows last 100 runs, then scans every 30 min for new deployments
⏱️
Timestamped Logs
Every event shows full YYYY-MM-DD HH:MM:SS timestamp for precise tracking
🎨
Beautiful CLI
Colorized output with elegant formatting and intuitive terminal interface
Quick Start
Prerequisites
- Node.js 16+ (Install)
- GitHub CLI (Install)
- GitHub CLI authentication (
gh auth login)
Installation
git clone https://github.com/vkumar-dev/github-deployment-streamer.git
cd github-deployment-streamer
npm install
node index.js
Run with Options
# Custom scan interval (default: 30 minutes)
node index.js --interval 15
# Verbose logging
node index.js --verbose
# Run in tmux for persistence
tmux new-session -d -s gh-streamer "cd $(pwd) && node index.js"
tmux attach -t gh-streamer
Features in Action
First Run - Load Last 100 Runs
┌─────────────────────────────────────────────────────────┐
│ │
│ 🚀 GitHub Deployment Streamer │
│ Real-time deployment monitoring across all repos │
│ │
└─────────────────────────────────────────────────────────┘
[2026-02-27 18:01:28] > ✓ Loaded last 100 deployment runs
┌─ Deployment Runs ──────────────────────────────────────┐
│
│ [2026-02-27 17:08:48] ✗ FAILED vkumar-dev/repo#5 "Run Inference"
│ [2026-02-27 16:35:50] ✓ SUCCESS vkumar-dev/repo#14 "Deploy"
│ [2026-02-27 16:35:33] 🔄 IN PROGRESS vkumar-dev/repo#102 "Build"
│
└────────────────────────────────────────────────────────┘
[2026-02-27 18:01:30] > 🔴 1 active stream(s) found. Starting...
Every 30 Minutes - Only New Runs
After the first scan, the tool shows only NEW runs from the last 30-minute window, preventing duplicate displays.
Real-time Streaming
When active runs are detected, they are automatically streamed with real-time status updates.
How It Works
Startup Sequence
- ✅ Checks GitHub CLI availability
- ✅ Verifies GitHub authentication
- ✅ Displays user details
- ✅ Lists all repositories
- ✅ Loads last 100 deployment runs
Continuous Monitoring
- 🔍 Shows status for each run (SUCCESS, FAILED, IN PROGRESS, CANCELLED)
- 🎯 Automatically detects and streams active runs in real-time
- 🔄 Scans every 30 minutes for new deployments
- 📊 Never re-displays the same run twice
Terminal Features
- 🔗 Clickable links to GitHub Actions pages
- 🎨 Color-coded output (green for success, red for failure, yellow for in-progress)
- ⏱️ Full timestamps on every event (YYYY-MM-DD HH:MM:SS)
- 📦 Organized display with repo names and run IDs
Use Cases
DevOps Teams
Monitor all deployments across multiple repositories in real-time. Perfect for deployment monitoring during releases.
CI/CD Monitoring
Keep track of build and test runs across your entire codebase. Quickly spot failures and bottlenecks.
Development Teams
See what your team is deploying and when. Great for awareness and debugging.
On-Call Engineers
Monitor production deployments from the terminal while working on other tasks.
Terminal Support
Works best with terminals that support OSC 8 hyperlinks for clickable links:
- ✅ VS Code Integrated Terminal
- ✅ iTerm2
- ✅ GNOME Terminal
- ✅ Windows Terminal
- ✅ Kitty
- ✅ Most modern terminals
Contributing
Contributions are welcome! Feel free to:
- 🐛 Report bugs and issues
- 💡 Suggest new features
- 🔧 Submit pull requests
- 📝 Improve documentation
Roadmap:
- Filter by repo name or status
- Export logs to file
- Web dashboard
- Slack/Discord notifications
- Custom refresh intervals per repo
- Run statistics and analytics