Log your GitHub Stars Contributions from the command line.

CLI: github-stars-contributions gsc

👨‍🏫 Awais taught and created this CLI project in his NodeCLI.com automation course

• 📦 Add a contribution of any type
• 🗃️ Remove a contribution in case of a mistake
• 🤯 Autocomplete search with type and filter function
• 🤯 Adding YouTube? gsc CLI can fetch title, date, and description for you
• 👨‍🏫 Awais taught and created this CLI project in his NodeCLI.com automation course

Install

# Recommended.
npx github-stars-contributions

# OR an alternative global install.
npm install -g github-stars-contributions
gsc # run global alias

Usage

The CLI supports both interactive (default) and non-interactive modes for automation.

Add Contributions

💬 Interactive Mode (Default)

Run gsc add and answer the prompts:

gsc add
# OR
gsc a

You'll be asked:

• Contribution Type
• URL (optional)
• Title
• Description
• Date

🤖 Non-Interactive Mode (Automation)

Perfect for CI/CD pipelines and scripts:

gsc add \
  -t BLOGPOST \
  -T "My Blog Post" \
  -D "Description here" \
  -d 2025-11-22 \
  -u https://example.com \
  -x

Remove Contributions

💬 Interactive Mode (Default)

Search and select contributions to remove:

gsc remove
# OR
gsc r

Search for the contribution, select it, and press enter to remove. Easy peasy!

🤖 Non-Interactive Mode (Automation)

Remove by contribution ID:

gsc remove -i <contribution-id> -x

Command Reference

Basic Syntax

github-stars-contributions <command> [options]
# OR
gsc <command> [options]

Global Options

| Option | Description | |--------|-------------| | -v, --version | Output the version number | | -h, --help | Display help for command |

Commands

| Command | Alias | Description | |---------|-------|-------------| | add [options] | a | Add a new contribution (interactive by default) | | remove [options] | r | Remove a contribution (interactive by default) | | help [command] | - | Display help for command |

add Command

Add a new contribution to your GitHub Stars profile.

Usage:

gsc add [options]
gsc a [options]

Options:

| Option | Description | Required | |--------|-------------|----------| | -t, --type <type> | Contribution type (see types below) | Yes (non-interactive) | | -T, --title <title> | Contribution title | Yes (non-interactive) | | -D, --description <description> | Contribution description | Yes (non-interactive) | | -d, --date <date> | Date in YYYY-MM-DD format (default: today) | Yes (non-interactive) | | -u, --url <url> | Contribution URL | No | | -x, --no-interactive | Disable interactive mode | No | | -h, --help | Display help | No |

Contribution Types:

• OTHER
• FORUM
• SPEAKING
• BLOGPOST
• HACKATHON
• VIDEO_PODCAST
• ARTICLE_PUBLICATION
• EVENT_ORGANIZATION
• OPEN_SOURCE_PROJECT

Examples:

# Interactive mode (default)
gsc add

# Non-interactive mode with all options
gsc add \
  -t BLOGPOST \
  -T "My Blog Post" \
  -D "Description here" \
  -d 2025-11-22 \
  -u https://example.com \
  -x

# Non-interactive without URL
gsc add -t SPEAKING -T "Conference Talk" -D "Talked about Node.js" -d 2025-11-20 -x

remove Command

Remove a contribution from your GitHub Stars profile.

Usage:

gsc remove [options]
gsc r [options]

Options:

| Option | Description | Required | |--------|-------------|----------| | -i, --id <id> | Contribution ID to remove | Yes (non-interactive) | | -x, --no-interactive | Disable interactive mode | No | | -h, --help | Display help | No |

Examples:

# Interactive mode (default) - search and select
gsc remove

# Non-interactive mode with ID
gsc remove -i abc123 -x

Changelog

❯ Read the changelog here →

KEY: 📦 NEW, 👌 IMPROVE, 🐛 FIX, 📖 DOC, 🚀 RELEASE, and 🤖 TEST

I use Emoji-log, you should try it and simplify your git commits.

License & Conduct

• Thanks to the GitHub team for an awesome GraphQL API.
• MIT © Ahmad Awais.
• Code of Conduct.

Connect