CLI: github-stars-contributions gsc

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

• 📦 Add a contribution of any type
• 🗃️ List your contributions
• 🤯 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

# Recommended.
npx github-stars-contributions

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

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

Note: The GraphQL contributions API is deprecated and will be removed on September 1, 2026. This CLI now uses the new REST contributions API by default. A --legacy-graphql flag is available on gsc add for migration until then.

Run gsc add (or just gsc) and answer the prompts:

gsc add
# OR
gsc a
# OR run with no command — jumps straight into add
gsc

You'll be asked:

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

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

Show all your contributions:

gsc list
# OR
gsc l

gsc list -x

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

Add a new contribution to your GitHub Stars profile.

Usage:

gsc add [options]
gsc a [options]

Options:

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

# Idempotent add/update with a stable client ID
gsc add -t BLOGPOST -T "My Blog Post" -D "Description here" -d 2025-11-22 -c my-blog-post -x

# Legacy GraphQL API (deprecated — removed September 1, 2026)
gsc add -t BLOGPOST -T "My Blog Post" -D "Description here" -d 2025-11-22 -L -x

The old GraphQL contributions API (api-stars.github.com) is deprecated and will be removed by GitHub on September 1, 2026.

• v4 of this CLI uses the new REST contributions API by default — no flags needed.
• If you have scripts pinned to older versions or need to double-check a migration, gsc add -L (--legacy-graphql) still talks to the legacy GraphQL API until September 1, 2026.
• After that date, the flag disappears from --help and the CLI always uses REST — no code changes needed on your side, just keep the CLI updated.
• gsc remove was removed in v4 because the REST API has no delete method. Delete contributions from the GitHub Stars website instead.

List your contributions from your GitHub Stars profile.

Usage:

gsc list [options]
gsc l [options]

Options:

Examples:

# Interactive mode (default)
gsc list

# Non-interactive mode
gsc list -x

❯ 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.

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