ghcheck

A simple CLI tool to check how active a GitHub user is, based on their recent public events.

Usage

pnpm dev <username>

Example

$ pnpm dev saadfarhan023
Checking saadfarhan023...
User: saadfarhan023
Top activity: PushEvent (21x), CreateEvent (9x)
Last active: 0 days ago
Verdict: ACTIVE
Longest run: 5 days

Verdict Logic

Verdict	Condition
ACTIVE	Last activity under 7 days
SEMI-ACTIVE	Last activity 7–30 days
GHOST	Over 30 days or no events

Setup

# Install dependencies
pnpm install

# Run in development mode
pnpm dev <username>

# Build
pnpm build

# Run the compiled version
pnpm start <username>

How It Works

1. Fetches the user's recent public events from the GitHub Events API.
2. Shows the top 3 most frequent event types (e.g. PushEvent, CreateEvent).
3. Calculates how many days since the user's last activity.
4. Assigns a verdict: ACTIVE, SEMI-ACTIVE, or GHOST.
5. Calculates the longest consecutive streak of days with at least one push event (within the retrieved event history).