Skip to content

Releases: ndk123-web/github-activity

v1.0.2 - Repository Scope, Activity Summary & Output Polish

28 Dec 15:41
@ndk123-web ndk123-web
v1.0.2
280145c

Choose a tag to compare

View all tags
v1.0.2 - Repository Scope, Activity Summary & Output Polish Latest
Latest

🏷️ Release Title

v1.0.2— Repository Scope, Activity Summary & Output Polish

📝 Release Notes

This release expands gh-activity with a fully-featured repository scope, improves summary insights, and tightens CLI output consistency.

The tool now provides clear, terminal-friendly views for both user activity and repository state, using GitHub’s public Events API.

✨ What’s New

📦 Repository Scope (repo)

  • Added repo <owner>/<repo> info command

  • Displays structured repository metadata:

    • Name & description
    • Primary language
    • License & visibility
    • Stars, forks, open issues
    • Created date, last update, last push
    • Topics rendered as [tag]

  • Includes a compact recent events summary (Push / Issues / Watches / Pull Requests)

gh-activity repo <owner>/<repo> info [--limit N]

--limit defines the size of the recent events window used for event counts.

📊 Improved Summary Command

  • summary now aggregates:

    • Pushes, pull requests, issues, watches
    • Top repositories by total activity

  • Clean, single-screen tabular output optimized for terminals

gh-activity user <username> summary [--limit N]

⭐ Watch (Star) Events

  • Added support for GitHub WatchEvent
  • Shows starred repositories grouped by repo
  • Consistent formatting with other user commands

🔐 Authentication & Error Handling Improvements

  • Auth status printed once per run
  • Invalid or expired tokens are automatically removed
  • Requests retry unauthenticated if needed
  • Clear rate-limit hints encourage token setup

🧹 Output & UX Polish

  • Unified table layouts across commands
  • Improved field grouping and ordering
  • Long descriptions normalized to preserve table alignment
  • Reduced noise; clearer separation between sections

⚙️ Supported Scopes & Commands

User scope

  • pushes
  • pulls (--state open|closed|merged)
  • issues (--state open|closed)
  • watches
  • summary

Repository scope

  • info (metadata + recent events overview)

📦 Distribution

  • Cross-platform ZIP releases:

    • Windows (amd64)
    • Linux (amd64)
    • macOS (amd64, arm64)

  • Single, self-contained binary per platform

  • No runtime dependencies

🧠 Notes

  • Data is based on GitHub’s recent events stream
  • --limit applies to the overall events window, not per event type
  • Designed for quick inspection, not historical analytics

🔄 Backward Compatibility

  • No breaking changes to existing commands
  • Improved output consistency across all scopes

🛣️ What’s Next

  • repo activity command
  • CI-driven automated releases
  • Optional JSON output for scripting

Tag: v1.0.2
License: MIT

Assets 6
Loading

Summary Command, Watch Events & Cross-Platform ZIP Builds

27 Dec 21:35
@ndk123-web ndk123-web
v1.0.1
bea336a

Choose a tag to compare

View all tags
Summary Command, Watch Events & Cross-Platform ZIP Builds

This release finalizes the core feature set of gh-activity and improves usability, output consistency, and cross-platform distribution.

gh-activity is a lightweight CLI for inspecting recent GitHub user activity (pushes, pull requests, issues, watches) using GitHub’s public Events API.

✨ What’s New in v1.0.1

📊 Summary Command

  • Added summary command to generate a high-level overview of recent activity.

  • Displays:

    • Total events
    • Push / Pull / Issue / Watch counts
    • Top repositories by aggregated activity

  • Clean, single-screen, tabular output.

gh-activity user <username> summary [--limit N]

⭐ Watch (Star) Events

  • Added support for GitHub WatchEvent.
  • Shows repositories starred by the user, grouped by repository.
  • Consistent table output with other commands.
gh-activity user <username> watches [--limit N]

🔐 Improved Authentication Handling

  • Clear guidance for creating GitHub Personal Access Tokens.
  • Automatic detection of invalid/expired tokens.
  • Invalid tokens are safely cleared and requests retried without authentication.
  • Token age warnings (90 days).

📦 Cross-Platform ZIP Releases

  • Official ZIP builds for:

    • Windows (amd64)
    • Linux (amd64)
    • macOS (amd64, arm64)

  • Each archive contains a ready-to-use bin/ directory.

  • No renaming required — just add bin/ to your PATH.

✅ Supported Commands

User Scope

  • pushes — View push activity
  • pulls — View pull requests (open / closed / merged)
  • issues — View issues (open / closed)
  • watches — View starred repositories
  • summary — Combined activity overview

⚙️ Installation

Download the ZIP for your OS from Assets, extract it, and add the bin/ directory to your PATH.

No Go installation required.

🧠 Notes on Data

  • Uses GitHub’s Events API (recent activity only)
  • One push event ≠ one commit
  • Summary aggregates events for insight, not full history

🔄 Backward Compatibility

  • No breaking changes to existing commands
  • Output is more consistent and structured

🛣️ What’s Next

  • Repository scope (repo info)
  • Optional JSON output
  • Linux/macOS tar.gz builds
  • CI-based automated releases

📄 Documentation

  • Updated README with installation, authentication, and usage examples
  • Internal design notes available in docs/

Tag: v1.0.1
License: MIT

Loading

Initial Release (v1.0.0) - windows amd64

27 Dec 11:48
@ndk123-web ndk123-web
v1.0.0
51c5c7a

Choose a tag to compare

View all tags
Initial Release (v1.0.0) - windows amd64

🚀 Initial Release — gh-activity (Windows amd64)

This is the first public release of gh-activity, a lightweight GitHub Activity CLI built in Go.

🎯 What is gh-activity?

gh-activity is a simple command-line tool to view recent GitHub activity for a user, using GitHub’s public Events API.
It focuses on clarity, strict CLI grammar, and developer-friendly output.

✅ Supported Platform (v1.0.0)

  • Windows: amd64 (64-bit)

Linux and macOS binaries will be added in upcoming releases.

✨ Features in this release

👤 User Activity Commands

  • Push Events

    gh-activity user <username> pushes [--limit N]

    View recent push activity, grouped by repository.

  • Pull Requests

    gh-activity user <username> pulls --state <open|closed|merged> [--limit N]

    View pull requests by state (merged, open, or closed).

  • Issues

    gh-activity user <username> issues --state <open|closed> [--limit N]

    View issue activity (pull requests are excluded).

🔒 Authentication & Rate Limits

  • Supports GitHub Personal Access Token
  • Token is stored locally in a secure config file
  • Automatically used for authenticated API requests
  • Graceful warnings for missing or old tokens

📊 Output Format

  • Clean, table-based output
  • Optimized for terminal usage
  • Designed to be easy to scan and script-friendly
  • Logs and warnings are separated from actual data output

⚙️ Design Highlights

  • Single self-contained binary (no runtime dependencies)
  • Manual CLI parsing (no heavy frameworks)
  • Strict command grammar and validation
  • Uses Go’s standard library only

📦 Installation (Windows)

  1. Download the binary from the Assets section

  2. Rename it to:

    gh-activity.exe

  3. Add it to your system PATH

  4. Verify:

    gh-activity --help

🛣️ Roadmap

Planned for next releases:

  • watch (⭐ star events)
  • summary command
  • Linux & macOS builds
  • JSON output (--json)
  • Improved documentation
Loading