GitHub Activity CLI

A simple command-line interface (CLI) tool that displays recent GitHub user activity, including commits, issues, and starred repositories.

Features

• Fetches recent activity for any GitHub user.

• Supports the following event types:

  • PushEvent → shows commits pushed to repositories
  • IssuesEvent → shows new issues opened
  • WatchEvent → shows repositories starred

• Handles network errors, user not found, and rate limit issues gracefully.

• Easy global installation via npm.

Installation

Install globally using npm:

npm install -g gh-activity

After installing globally, you can use the CLI anywhere in your terminal.

Usage

Run the CLI with a GitHub username as an argument:

gh-activity <github-username>

Example:

gh-activity octocat

Output:

- Pushed 3 commits to octocat/Hello-World
- Opened a new issue in octocat/Hello-World
- Starred octocat/Hello-World

Error Handling

• Network error: Check your internet connection
• User not found: GitHub username does not exist
• Rate limit exceeded: Too many requests; try again later
• Unexpected error: Some other error occurred