ctinnovation/gitstronaut

Have a lot of packages on your account? Explore them smoothly with gitstronaut 🚀

gitstronaut 𐫴 generated by AI

gitstronaut

Have a lot of packages on your GitHub account? Explore them smoothly with gitstronaut 🚀

• Installation
• Explore
• Tags
• Authenticate with GitHub
• Arguments

Installation

This tool needs NodeJS and it is tested with node version 20.X.

npm i -g gitstronaut
gitstronaut explore

Explore

Usage:

gitstronaut explore [--ARGS]

With explore, for each repository, gitstronaut will give you information about:

• Branches: warning you about un-protected and pending branches
• Pull requests: warning you about Pull Requests that are open and not merged
• Tags: warning you when the default branch is not aligned with the latest tag (and how many commits are between the two)

If you're using changescribe for handling your CHANGELOGs gitstronaut will also hint you the likely next release needed for that repo.

Tags

Usage:

gitstronaut tags [--ARGS]

With tags command gitstraonaut will summarize the latest tag for each repo and if the default branch is aligned with it or not.

Authenticate with GitHub

There are two ways to authenticate with this CLI:

• By passing an argument --token -t with a (personal or fine-grained) access token from GitHub (required at least read access to repositories and contents)
• If not passing any --token argument you will required to grant access to this CLI through your browser with a device code, follow the istructions on your cool terminal

Arguments

Argument	Description	Type
-f, --filter	Explore repositories with this filter (RegExp accepted)
-o, --organization	Explore repositories whitin orgaizationb	[string]
--showUrls	Show URL of referred data (more verbose)	[boolean] [default: false]
-t, --token	Token for access to GitHub	[string]
--help	Show help	[boolean]
--version	Show version number	[boolean]

gitstronaut's Issues

List repo's name as link

New feature: show the repositories in list as links to directly open the github repo.

Filter repositories by task name

Description

New feature: explore repositories by task name. Useful when there is a task open and you want to get all the repositories involved with that task.

Implementation

With this feature implemented, this tool should filter all the repos that includes that task name inside their branches or in the commits from latest tag to main head. Practically, this feature should allow to add a filter on the repos branches.

Deployment

This feature can be deployed as:

• A new command
• A new option for explore command

Filter repositories by topics

• Filter repositories by topic
• Hide archived repositories by default

Migration to GraphQL

• Migrate all Github API usage to graphQL instead of REST