Improve README, add screenshots

Author: tstromberg

README.md

@@ -1,62 +1,66 @@
 # 🚀 prs
 
-> Only shows PRs waiting on YOU - preserving your focus time and sanity
+> Only shows PRs waiting on YOU
 
-A blazingly fast CLI tool that filters out all the noise to show only the PRs that need your action. No more context switching through dozens of PRs that don't need you right now.
+A fast CLI that filters GitHub PRs to show only what needs your attention. No more digging through dozens of PRs to find the ones that actually need you.
 
 ## Quick Start
 
 ```bash
 go install github.com/ready-to-review/prs@latest
+prs
 ```
 
-**Prerequisites:** Go 1.23+ and GitHub CLI (`gh`) authenticated
+**Requirements:** Go 1.23+ and GitHub CLI (`gh`) authenticated
 
 ## Usage
 
 ```bash
-# The default - shows ONLY PRs waiting on your input
+# Show PRs you're involved with (filters out stale PRs)
 prs
 
-# See everything you're involved with (if you really want to)
-prs --all
+# Only PRs waiting for your review
+prs --blocked
+
+# Include old/stale PRs
+prs --include-stale
 
-# Stay focused - auto-refresh what needs your attention (every 10 min)
+# Auto-refresh view
 prs --watch
 
-# Get alerted to newly blocking PRs (notifications currently unavailable)
+# Get notified when PRs need attention
 prs --notify
 ```
 
 ## What You'll See
 
-```
-🔥 2 PRs awaiting your review
-
-⬇️  Incoming PRs
+### Default View (`prs`)
+![Default View](media/default.png)
 
-  ● 🚧 Fix authentication bug ⚡
-     3h • https://github.com/org/repo/pull/123
+### Focus Mode (`prs --blocked`)
+![Watch Blocked View](media/watch_blocked.png)
 
-  ● ✅ Add user preferences
-     1d • https://github.com/org/repo/pull/456
-
-⬆️  Your PRs
+## Options
 
-  ● 📝 Update documentation
-     2h • https://github.com/org/repo/pull/789
-```
+- `--blocked` - Only PRs blocking on you
+- `--include-stale` - Include old PRs (hidden by default)
+- `--watch` - Live updates
+- `--notify` - Desktop notifications
+- `--org` - Filter to specific organization
+- `--debug` - Show debug info
 
-## Options
+## Status Icons
 
-- `--all` - Show all your PRs, not just review requests
-- `--watch` - Keep watching for updates (10 min intervals)
-- `--watch-interval N` - Customize refresh rate (minutes)
-- `--notify` - New PR alerts (⚠️ currently disabled)
-- `--verbose` - Debug mode for the curious
+- 🚧 Draft PR
+- ✅ Ready to merge
+- 👍 Has approval
+- 💥 Merge conflict
+- ⏰ Stale PR
+- ❌ Failing tests
+- 📝 Regular PR
 
-## Why This Exists
+## Why This Tool?
 
-**Focus is precious.** This tool shows ONLY the PRs blocked on your input - nothing else. No PRs waiting on CI, no PRs waiting on other reviewers, no PRs you've already reviewed. Just the ones that need you, right now.
+Stop context switching through GitHub tabs. This tool uses smart filtering to show only PRs that actually need your input - not PRs waiting on CI, other reviewers, or ones you've already reviewed.
 
-Built with Go for speed, because waiting for your tools is another focus killer.
+Built fast in Go because your development tools shouldn't slow you down.

main.go

@@ -193,6 +193,7 @@ func main() {
 		notify        = flag.Bool("notify", false, "Watch for PRs and notify when they become newly blocking")
 		turnServer    = flag.String("turn-server", defaultTurnServerURL, "Turn server URL for enhanced metadata")
 		org           = flag.String("org", "", "Filter PRs to specific organization")
+		includeStale  = flag.Bool("include-stale", false, "Include stale PRs in the output")
 		debug         bool
 	)
 	flag.BoolVar(&debug, "debug", false, "Show debug information including API calls and turnclient data")
@@ -278,7 +279,7 @@ func main() {
 
 	// If either watch or notify is set, run in watch mode
 	if *watch || *notify {
-		runWatchMode(ctx, token, username, *blocked, *notify, *watchInterval, logger, httpClient, turnClient, debug, *org)
+		runWatchMode(ctx, token, username, *blocked, *notify, *watchInterval, logger, httpClient, turnClient, debug, *org, *includeStale)
 	} else {
 		// One-time display
 		prs, err := fetchPRsWithRetry(ctx, token, username, logger, httpClient, turnClient, debug, *org)
@@ -290,7 +291,7 @@ func main() {
 			}
 			os.Exit(1)
 		}
-		displayPRs(prs, username, *blocked, debug)
+		displayPRs(prs, username, *blocked, debug, *includeStale)
 	}
 }
 
@@ -707,7 +708,27 @@ func isBlockingOnUser(pr PR, username string) bool {
 	return false
 }
 
-func displayPRs(prs []PR, username string, blockingOnly bool, debug bool) {
+func displayPRs(prs []PR, username string, blockingOnly bool, debug bool, includeStale bool) {
+	// Filter out stale PRs unless includeStale is true
+	if !includeStale {
+		var filteredPRs []PR
+		for _, pr := range prs {
+			isStale := false
+			if pr.TurnResponse != nil {
+				for _, tag := range pr.TurnResponse.PRState.Tags {
+					if tag == "stale" {
+						isStale = true
+						break
+					}
+				}
+			}
+			if !isStale {
+				filteredPRs = append(filteredPRs, pr)
+			}
+		}
+		prs = filteredPRs
+	}
+
 	incoming, outgoing := categorizePRs(prs, username)
 	blockingCount := countBlockingPRs(incoming, username, debug)
 
@@ -990,7 +1011,7 @@ func truncateURL(url string, maxLen int) string {
 	return truncate(url, maxLen)
 }
 
-func runWatchMode(ctx context.Context, token, username string, blockingOnly bool, notifyMode bool, interval time.Duration, logger *log.Logger, httpClient *http.Client, turnClient *turn.Client, debug bool, org string) {
+func runWatchMode(ctx context.Context, token, username string, blockingOnly bool, notifyMode bool, interval time.Duration, logger *log.Logger, httpClient *http.Client, turnClient *turn.Client, debug bool, org string, includeStale bool) {
 	// Clear screen only if not in notify mode
 	if !notifyMode {
 		fmt.Print("\033[H\033[2J")
@@ -1013,7 +1034,7 @@ func runWatchMode(ctx context.Context, token, username string, blockingOnly bool
 			header := "🔄 Live PR Dashboard - Press 'q' to quit"
 			fmt.Println(titleStyle.Render(header))
 			fmt.Println()
-			displayPRs(prs, username, blockingOnly, debug)
+			displayPRs(prs, username, blockingOnly, debug, includeStale)
 		}
 	}
 
@@ -1049,7 +1070,7 @@ func runWatchMode(ctx context.Context, token, username string, blockingOnly bool
 				header := "🔄 Live PR Dashboard - Press 'q' to quit"
 				fmt.Println(titleStyle.Render(header))
 				fmt.Println()
-				displayPRs(prs, username, blockingOnly, debug)
+				displayPRs(prs, username, blockingOnly, debug, includeStale)
 			}
 			// In notify mode, don't clear screen - just show new PRs below