A powerful Rust CLI tool to automatically update all your forked GitHub repositories, keeping them in sync with their upstream sources.

When you fork repositories on GitHub, they quickly become out of date as the upstream repositories receive new commits. github-rs solves this problem by automatically synchronizing all your forks with their upstream repositories, helping you maintain up-to-date copies and reduce merge conflicts.

• Bulk Fork Updates: Automatically update all your forked repositories in one command
• Smart Synchronization: Keeps your forks in sync with upstream changes
• Conflict Detection: Identifies potential merge conflicts before they become problems
• Fast Performance: Built in Rust for speed and reliability
• GitHub API Integration: Seamlessly integrates with GitHub's API
• Minimal Configuration: Simple setup with GitHub token authentication

git clone https://github.com/yonasBSD/github-rs.git
cd github-rs
cargo build --release

The binary will be available at target/release/github-rs.

cargo install --git https://github.com/yonasBSD/github-rs.git

1. Generate a GitHub Personal Access Token

   Create a token with repo scope at: https://github.com/settings/tokens

2. Set Up Authentication

   export GITHUB_TOKEN="your_token_here"

3. Run the Tool

   github-rs

   This will scan all your forked repositories and update them with the latest changes from their upstream sources.

Update all your forked repositories:

github-rs

github-rs [OPTIONS]

Options:
  -h, --help           Print help information
  -V, --version        Print version information

• GITHUB_TOKEN - Your GitHub personal access token (required)
• GITHUB_USER - Your GitHub username (optional, auto-detected from token)

Your GitHub token needs the following scopes:

• repo - Full control of private repositories
• workflow - Update GitHub Action workflows (if needed)

1. Discovery: Fetches all repositories you've forked on GitHub
2. Analysis: Identifies which forks are behind their upstream repositories
3. Synchronization: Merges upstream changes into your fork's default branch
4. Report: Provides a summary of updated repositories and any issues encountered

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

# Clone the repository
git clone https://github.com/yonasBSD/github-rs.git
cd github-rs

# Install dependencies
cargo build

# Run tests
cargo test

# Run with cargo
cargo run

# Run all tests
cargo test

# Run tests with coverage
cargo test --all-features

# Run linting
cargo clippy -- -D warnings

# Format code
cargo fmt

• Rust 1.70.0 or higher
• GitHub Personal Access Token with appropriate permissions
• Active internet connection

• Never commit your GitHub token to version control
• Use environment variables or secure credential managers
• Review the Security Policy for reporting vulnerabilities

This project is licensed under the terms specified in LICENSE.md.

• Generated from yonasBSD/rust-ci-github-actions-workflow
• Built with the power of Rust 🦀
• Inspired by the need to keep countless forks synchronized

This project is actively maintained. Check the Issues page for known problems and feature requests.

• hub - GitHub CLI wrapper
• gh - Official GitHub CLI
• git-sync - Keep Git repos in sync

• 🐛 Report a Bug
• 💡 Request a Feature
• 📖 Documentation

See CHANGELOG.md for a list of changes and version history.

Note: This tool modifies your GitHub repositories. Always review changes before pushing to production environments. Consider testing on non-critical forks first.