🌟 Thanks Stars

Thanks Stars is a command-line companion that stars the GitHub repositories powering your project so you can show appreciation to the maintainers of your dependencies. It draws inspiration from teppeis/thank-you-stars, but reimagines the experience in Rust with first-class support for multiple ecosystems.

https://github.com/user-attachments/assets/d7a7b047-312e-4d56-ba5d-25ed6eb2e5ce

✨ Highlights

• Detects dependencies across popular package managers and build tools.
• Uses your GitHub personal access token to star repositories on your behalf.
• Provides friendly progress output and summarizes what happened at the end of a run.

🧭 Supported Ecosystems

The following ecosystems are currently detected when you run the tool:

| Ecosystem | Detection Source | Implementation | | --------------- | ------------------------------------------------------------------------------ | ---------------------------------------------------------- | | Cargo (Rust) | Cargo.toml | src/ecosystems/cargo.rs | | Node.js | package.json | src/ecosystems/node.rs | | Deno | deno.lock, deno.json, deno.jsonc | src/ecosystems/deno.rs | | JSR | jsr.json | src/ecosystems/jsr.rs | | Go (Go Modules) | go.mod | src/ecosystems/go.rs | | Dart | pubspec.yaml | src/ecosystems/dart.rs | | Composer (PHP) | composer.lock / composer.json | src/ecosystems/composer.rs | | Ruby (Bundler) | Gemfile / Gemfile.lock | src/ecosystems/ruby.rs | | Python | pyproject.toml / requirements.txt / Pipfile / Pipfile.lock / uv.lock | src/ecosystems/python.rs | | R (renv) | renv.lock | src/ecosystems/renv.rs | | Gradle | gradle.lockfile / build.gradle / build.gradle.kts | src/ecosystems/gradle.rs | | Maven | pom.xml | src/ecosystems/maven.rs | | Haskell | package.yaml / *.cabal / stack.yaml / cabal.project | src/ecosystems/haskell.rs |

Looking for support for a different ecosystem? Open an ecosystem support request and tell us about the manifest and lockfiles we should detect.

🚀 Installation

Choose the installation method that best fits your environment:

🍺 Homebrew

$ brew tap Kenzo-Wada/thanks-stars
$ brew install thanks-stars

🦀 Cargo

$ cargo install thanks-stars

📦 npm

$ npm install -g thanks-stars

💻 Shell installer (macOS/Linux)

$ curl -LSfs https://github.com/Kenzo-Wada/thanks-stars/releases/latest/download/thanks-stars-installer.sh | sh

🪟 PowerShell installer (Windows)

$ iwr https://github.com/Kenzo-Wada/thanks-stars/releases/latest/download/thanks-stars-installer.ps1 -useb | iex

🐧 Linux package managers

Native packages like apt/apt-get, pacman, nix, etc... are not published yet. Until a maintainer volunteers to host those repositories, please use one of the installers above or the manual download method. Contributions toward official Linux packages are very welcome—see CONTRIBUTING.md for coordination details.

📦 Manual download

Grab the archive for your platform from the GitHub Releases page and place the thanks-stars binary somewhere on your PATH.

🛠 Usage

Authenticate once with a GitHub personal access token, then run the tool in the root of your project.

Authenticate with GitHub

$ thanks-stars auth --token ghp_your_token_here

If you omit --token, the command will prompt you to paste it securely. By default the configuration is stored in a user-specific config.toml; you can override the storage location with the THANKS_STARS_CONFIG_DIR environment variable.

Run inside your project

$ cd path/to/your/project
$ thanks-stars

Example output:

$ thanks-stars
⭐ Starred https://github.com/xxx/xxx via Cargo.toml
✅ Already starred https://github.com/xxx/xxx via package.json
...
✨ Completed! ⭐ Starred 10 repositories.

Run thanks-stars --help to explore all available options.

Preview your run with --dry-run

If you want to see which repositories would be starred without making any changes to your GitHub account, pass the --dry-run flag:

$ thanks-stars --dry-run
⭐ Would star https://github.com/xxx/xxx via Cargo.toml
✅ Already starred https://github.com/xxx/yyy via package.json
✨ Dry run complete! ⭐ 1 repository would be starred, ✅ 1 already starred.

The command still inspects your dependencies so it can report which ones are already starred, but it avoids sending any API requests that would change your starred repositories.

Thanks Stars helps you recognize the maintainers who keep your stack running—so while you're at it, don't forget to ⭐ this project too!