gh-summary 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 228ab8d8992d696d9e505a82f4ea178824652fffd40ec56c860f34d3ef2e5853
+  data.tar.gz: 5f8fac59f24a7a5e725d83fdb894684ed658bb454ddf02c874bc86705a06d57c
+SHA512:
+  metadata.gz: 6a4208d706a7626fc6e74149bab22b0e0b277f49bce7df6e6b9b1ecd68179769d3761254635bd239c5c1a465088682a44f9bdbc24eaaca6940a6d88b0ae6ef64
+  data.tar.gz: 133ba481345bedb37913f1b27c0ef0e95baa66b42fa3bb147cdc55de9904ef29a405362ca595ff364b5196819ec5dcce248c843903f821032f919aa839236803

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nikita Miloserdov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,101 @@
+# gh-summary
+
+[![Gem Version](https://badge.fury.io/rb/gh-summary.svg)](https://rubygems.org/gems/gh-summary)
+
+Your GitHub day at a glance — PRs, reviews, issues, notifications — all in one terminal command.
+
+Zero dependencies. Ruby + `gh` CLI.
+
+## Install
+
+```
+gem install gh-summary
+```
+
+## Requirements
+
+- Ruby >= 3.0
+- [gh](https://cli.github.com/), authenticated
+
+## Usage
+
+```
+gh-summary
+gh-summary --short
+```
+
+`--short` skips the recent activity section.
+
+## Output
+
+```
+  GitHub Summary  2026-04-13 14:54
+────────────────────────────────────────────────────────────
+  PRs awaiting your review
+    torvalds/linux — Fix memory leak in page allocator
+      https://github.com/torvalds/linux/pull/842
+    rails/rails — ActiveRecord: add async batch find
+      https://github.com/rails/rails/pull/51203
+  (2 pending)
+────────────────────────────────────────────────────────────
+  Your open PRs
+    matz/ruby — Optimize frozen string dedup in parser
+      https://github.com/matz/ruby/pull/9104
+    sinatra/sinatra — Add streaming response helpers
+      https://github.com/sinatra/sinatra/pull/1877
+    rack/rack — Fix multipart boundary parsing edge case
+      https://github.com/rack/rack/pull/2190
+  (3 open)
+────────────────────────────────────────────────────────────
+  Issues assigned to you
+    homebrew/brew — Formula audit fails on Apple Silicon
+      https://github.com/homebrew/brew/issues/17450
+  (1 open)
+────────────────────────────────────────────────────────────
+  Unread notifications
+    rails/rails (3):
+      [Issue] ActiveStorage mirror sync regression (mention)
+      [PullRequest] Fix connection pool exhaustion (review_requested)
+      [Release] v8.1.0 (subscribed)
+    ruby/ruby (1):
+      [Issue] YJIT segfault on ARM64 (assign)
+  (4 total unread)
+────────────────────────────────────────────────────────────
+  Recent activity (your repos)
+  Repo                            Type             Action      Date
+  matz/ruby                       PullRequest      opened      2026-04-12
+  sinatra/sinatra                 Issues           closed      2026-04-11
+  rack/rack                       PullRequest      merged      2026-04-10
+────────────────────────────────────────────────────────────
+```
+
+## Tests
+
+```
+make test
+```
+
+## Structure
+
+```
+.
+├── bin
+│   └── gh-summary
+├── lib
+│   ├── gh_summary
+│   │   ├── auth_error.rb
+│   │   ├── cli.rb
+│   │   ├── colors.rb
+│   │   ├── github.rb
+│   │   └── runner.rb
+│   └── gh_summary.rb
+├── Makefile
+├── README.md
+└── test
+    ├── test_auth_error.rb
+    ├── test_cli.rb
+    ├── test_colors.rb
+    ├── test_github.rb
+    ├── test_helper.rb
+    └── test_runner.rb
+```

data/bin/gh-summary

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
+
+require "gh_summary"
+
+begin
+  GhSummary::Runner.new(short: ARGV.include?("--short")).run
+rescue GhSummary::AuthError => error
+  GhSummary::CLI.new.error("Error: #{error.message}")
+  exit 1
+end

data/lib/gh_summary/auth_error.rb

@@ -0,0 +1,3 @@
+module GhSummary
+  class AuthError < StandardError; end
+end

data/lib/gh_summary/cli.rb

@@ -0,0 +1,79 @@
+module GhSummary
+  class CLI
+    include Colors
+
+    INDENT_SECTION = 2
+    INDENT_ITEM    = 4
+    INDENT_SUB     = 6
+
+    def initialize
+    end
+
+    def divider
+      output "#{DIM}#{"─" * 60}#{RESET}"
+    end
+
+    def header(color, text)
+      divider
+      output "#{BOLD}#{color}#{left_padding(text, INDENT_SECTION)}#{RESET}"
+    end
+
+    def item(repository, title, url)
+      output left_padding("#{repository} — #{title}", INDENT_ITEM)
+      output left_padding(url, INDENT_SUB)
+    end
+
+    def sub_item(text)
+      output left_padding(text, INDENT_SUB)
+    end
+
+    def group(label)
+      output left_padding(label, INDENT_ITEM)
+    end
+
+    def count(number, label)
+      output "#{DIM}#{left_padding("(#{number} #{label})", INDENT_SECTION)}#{RESET}"
+    end
+
+    def empty(text)
+      output "#{DIM}#{left_padding(text, INDENT_SECTION)}#{RESET}"
+    end
+
+    def success(text)
+      output "#{GREEN}#{left_padding(text, INDENT_SECTION)}#{RESET}"
+    end
+
+    def error(text)
+      $stderr.puts "#{RED}#{left_padding(text, INDENT_SECTION)}#{RESET}"
+    end
+
+    def banner
+      output "\n#{BOLD}#{CYAN}#{left_padding("GitHub Summary", INDENT_SECTION)}#{RESET}  #{DIM}#{Time.now.strftime("%Y-%m-%d %H:%M")}#{RESET}"
+    end
+
+    def table(columns, rows)
+      column_widths = columns.map(&:length)
+      rows.each do |row|
+        row.each_with_index { |cell, index| column_widths[index] = [column_widths[index] || 0, cell.length].max }
+      end
+
+      format_string = column_widths.map { |width| "%-#{width}s" }.join("  ")
+      output "#{DIM}#{left_padding(sprintf(format_string, *columns), INDENT_SECTION)}#{RESET}"
+      rows.each { |row| output left_padding(sprintf(format_string, *row), INDENT_SECTION) }
+    end
+
+    def newline
+      output
+    end
+
+    private
+
+    def output(text = "")
+      puts text
+    end
+
+    def left_padding(text, spacing = INDENT_SECTION)
+      "#{" " * spacing}#{text}"
+    end
+  end
+end

data/lib/gh_summary/colors.rb

@@ -0,0 +1,12 @@
+module GhSummary
+  module Colors
+    BOLD    = "\033[1m"
+    DIM     = "\033[2m"
+    CYAN    = "\033[36m"
+    YELLOW  = "\033[33m"
+    GREEN   = "\033[32m"
+    RED     = "\033[31m"
+    MAGENTA = "\033[35m"
+    RESET   = "\033[0m"
+  end
+end

data/lib/gh_summary/github.rb

@@ -0,0 +1,46 @@
+require "json"
+require "open3"
+
+module GhSummary
+  class GitHub
+    def initialize
+      unless system("gh", "auth", "status", out: File::NULL, err: File::NULL)
+        raise AuthError, "gh is not authenticated. Run 'gh auth login' first."
+      end
+    end
+
+    def search_prs(**options)
+      flags = options.map { |key, value| "--#{key}=#{value}" }
+      fetch_json("search", "prs", *flags, "--json", "title,repository,url,updatedAt", "--limit", "15")
+    end
+
+    def search_issues(**options)
+      flags = options.map { |key, value| "--#{key}=#{value}" }
+      fetch_json("search", "issues", *flags, "--json", "title,repository,url", "--limit", "15")
+    end
+
+    def notifications
+      fetch_json("api", "notifications")
+    end
+
+    def events(per_page: 20)
+      fetch_json("api", "events", "-f", "per_page=#{per_page}")
+    end
+
+    private
+
+    def execute(*arguments)
+      output, _stderr, status = Open3.capture3("gh", *arguments)
+      status.success? ? output : nil
+    end
+
+    def fetch_json(*arguments)
+      output = execute(*arguments)
+      return [] unless output
+      parsed = JSON.parse(output)
+      parsed.is_a?(Array) ? parsed : [parsed]
+    rescue JSON::ParserError
+      []
+    end
+  end
+end

data/lib/gh_summary/runner.rb

@@ -0,0 +1,89 @@
+module GhSummary
+  class Runner
+    include Colors
+
+    RELEVANT_EVENTS = %w[IssuesEvent PullRequestEvent ReleaseEvent ForkEvent WatchEvent].freeze
+
+    def initialize(short: false)
+      @short_mode = short
+      @cli = CLI.new
+      @github = GitHub.new
+    end
+
+    def run
+      @cli.banner
+      show_section(
+        YELLOW, "PRs awaiting your review",
+        @github.search_prs("review-requested": "@me", state: "open"),
+        empty: "None — you're clear!", empty_style: :success, count_label: "pending"
+      )
+      show_section(
+        GREEN, "Your open PRs",
+        @github.search_prs(author: "@me", state: "open"),
+        empty: "No open PRs", count_label: "open"
+      )
+      show_section(
+        RED, "Issues assigned to you",
+        @github.search_issues(assignee: "@me", state: "open"),
+        empty: "No assigned issues", count_label: "open"
+      )
+      show_notifications
+      show_recent_activity unless @short_mode
+      @cli.divider
+      @cli.newline
+    end
+
+    private
+
+    def repository_name(item)
+      item.dig("repository", "nameWithOwner") || item.dig("repository", "name") || "?"
+    end
+
+    def show_section(color, title, items, empty:, count_label:, empty_style: :empty)
+      @cli.header(color, title)
+      if items.any?
+        items.each { |item| @cli.item(repository_name(item), item["title"], item["url"]) }
+        @cli.count(items.size, count_label)
+      else
+        @cli.send(empty_style, empty)
+      end
+    end
+
+    def show_notifications
+      @cli.header(MAGENTA, "Unread notifications")
+      notifications = @github.notifications
+      if notifications.any?
+        grouped_notifications = notifications.group_by { |notification| notification.dig("repository", "full_name") || "unknown" }
+        grouped_notifications.each do |repository, notification_items|
+          @cli.group("#{repository} (#{notification_items.size}):")
+          notification_items.first(5).each do |notification|
+            subject_type   = notification.dig("subject", "type") || "?"
+            subject_title  = notification.dig("subject", "title") || "?"
+            reason         = notification["reason"] || "?"
+            @cli.sub_item("[#{subject_type}] #{subject_title} (#{reason})")
+          end
+        end
+        @cli.count(notifications.size, "total unread")
+      else
+        @cli.success("All caught up!")
+      end
+    end
+
+    def show_recent_activity
+      @cli.header(CYAN, "Recent activity (your repos)")
+      all_events = @github.events(per_page: 20)
+      relevant_events = all_events.select { |event| RELEVANT_EVENTS.include?(event["type"]) }.first(10)
+      if relevant_events.any?
+        rows = relevant_events.map do |event|
+          [event.dig("repo", "name") || "?",
+           (event["type"] || "").sub("Event", ""),
+           event.dig("payload", "action") || "—",
+           (event["created_at"] || "").split("T").first]
+        end
+        @cli.table(%w[Repo Type Action Date], rows)
+      else
+        @cli.empty("No recent events")
+      end
+    end
+  end
+end

data/lib/gh_summary/version.rb

@@ -0,0 +1,3 @@
+module GhSummary
+  VERSION = "0.1.0"
+end

data/lib/gh_summary.rb

@@ -0,0 +1,6 @@
+require_relative "gh_summary/version"
+require_relative "gh_summary/auth_error"
+require_relative "gh_summary/colors"
+require_relative "gh_summary/cli"
+require_relative "gh_summary/github"
+require_relative "gh_summary/runner"

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification
+name: gh-summary
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Nikita Miloserdov
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: Shows open PRs, review requests, assigned issues, unread notifications,
+  and recent activity. Wraps the gh CLI. No dependencies.
+email:
+- nmiloserdov@proton.me
+executables:
+- gh-summary
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- bin/gh-summary
+- lib/gh_summary.rb
+- lib/gh_summary/auth_error.rb
+- lib/gh_summary/cli.rb
+- lib/gh_summary/colors.rb
+- lib/gh_summary/github.rb
+- lib/gh_summary/runner.rb
+- lib/gh_summary/version.rb
+homepage: https://github.com/wh1le/gh-summary
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/wh1le/gh-summary
+  source_code_uri: https://github.com/wh1le/gh-summary
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.2
+specification_version: 4
+summary: GitHub activity digest in your terminal
+test_files: []