An open API service indexing awesome lists of open source software.

https://github.com/rustunit/orgstars

CLI tool to count all stars under a GitHub Org
https://github.com/rustunit/orgstars

Last synced: 28 days ago
JSON representation

CLI tool to count all stars under a GitHub Org

Awesome Lists containing this project

README

          

# orgstars

[![crates.io](https://img.shields.io/crates/v/orgstars.svg)](https://crates.io/crates/orgstars)
[![discord](https://img.shields.io/discord/1176858176897953872?label=discord&color=5561E6)](https://discord.gg/MHzmYHnnsE)

A simple command-line tool to query GitHub's API and sum up all the stars across all repositories in an organization.

## Installation

```bash
cargo install orgstars
```

## Usage

Query stars for any GitHub organization:

```bash
orgstars --org rust-lang
```

### With Authentication

To avoid GitHub API rate limits, you can provide a personal access token:

```bash
orgstars --org rust-lang --token YOUR_GITHUB_TOKEN
```

### Example Output

```
Fetching repositories for organization: rust-lang

Results for organization: rust-lang
Total repositories: 232
Total stars: 372526

Repository breakdown:
rust - 108154 stars
rustlings - 60798 stars
mdBook - 20700 stars
book - 16968 stars
...
```

## Features

- Fetches all repositories from a GitHub organization using pagination
- Displays total star count across all repositories
- Shows a sorted breakdown of stars per repository
- Supports authentication via GitHub personal access tokens
- Handles rate limiting gracefully

## Options

```
Options:
-o, --org GitHub organization name
-t, --token GitHub personal access token (optional)
-h, --help Print help
```

## License

Licensed under either of

- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)

at your option.