How to set up Revup for contributing to open-source projects with forks?

Add git remotes for both the main repo and your fork, then run revup upload with --remote-name for the main repo and --fork-name for your fork. This pushes changes to the fork while creating pull requests in the original repository, as detailed in the 'Work with forks' section.

Revup vs ghstack: which is better for managing stacked diffs on GitHub?

Revup builds on ghstack's code and adds features like rebase detection and more configurable options, but ghstack is more established. Choose Revup for enhanced automation and cost savings, or ghstack if you prefer a tool with longer community history.

What Git version is required for Revup and how do I upgrade?

Revup requires Git 2.43 or higher. Upgrade by following official Git installation instructions for your OS, as Revup uses newer Git flags not available in older versions, which is explicitly stated in the compatibility notes.

How does Revup handle rebases to avoid unnecessary CI runs?

Revup detects when patch content hasn't changed after a rebase and skips re-uploading, preventing new CI builds. You can override this with the --rebase flag, but default behavior saves time and resources, as explained in the rebase detection feature.

Can I use Revup with other Git hosts like GitLab?

No, Revup is designed specifically for GitHub integration using its GraphQL API. For other hosts, you'd need alternative tools or custom development, as current implementation doesn't support platforms like GitLab or Bitbucket.

What are the common commit tags in Revup and how do they work?

Key tags include 'Topic:' to group commits into PRs, 'Relative:' for dependencies, and 'Reviewers:', 'Labels:' for automation. Add these in commit messages, and Revup parses them to manage PR creation and configuration, as shown in the tutorial examples.

Open-Awesome

skydio/revup

MITPythonv0.4.0

A productivity-focused Git tool that creates and manages multiple relative pull requests from a single upload.

Visit Website GitHub

391 stars108 forks0 contributors

What is skydio/revup?

Revup is a Git command-line tool designed to streamline the process of creating and managing multiple pull requests from a single set of commits. It solves the problem of iterative development on parallel changes by automating branch creation, tracking patch revisions, and integrating with GitHub to reduce manual overhead. Developers can upload once and have Revup handle the complexity of dependent and independent code reviews.

Target Audience

Developers and engineering teams who frequently work on multiple related features or bug fixes simultaneously and want to optimize their Git and code review workflow, particularly those familiar with stacked diffs or commit-based development.

Value Proposition

Revup saves time and reduces CI costs by intelligently managing pull requests with features like rebase detection and automated branch handling. Its unique approach to creating relative PRs from a single upload, combined with tools for easy amendments and enhanced PR navigation, makes it a powerful alternative to manual Git operations for productivity-focused teams.

Overview

Upload once to create multiple, relative PRs. Productivity-focused git tools with patch revision tracking, rebase detection and more. Uses python and git plumbing commands.

Use Cases

Best For

Managing multiple dependent pull requests for a feature chain
Reducing manual overhead in creating and updating GitHub PRs
Optimizing CI usage by avoiding unnecessary rebuilds on unchanged patches
Contributing to open-source projects using a fork-based workflow
Teams adopting a stacked diffs or commit-based development methodology
Automating reviewer assignment and labeling from commit messages

Not Ideal For

Teams using Git hosting platforms other than GitHub, such as GitLab or Bitbucket
Developers who prefer graphical interfaces or minimal CLI tooling for Git operations
Projects with linear development workflows where only a single pull request is active at any time
Organizations with restrictive branch policies that prevent automated branch creation and modification

Pros & Cons

Pros

Automated PR Chains

Creates multiple independent or dependent pull requests from a single upload, handling branch management and targeting automatically based on commit tags like 'Topic:' and 'Relative:'.

CI Cost Savings

Detects when patches haven't changed after a rebase, avoiding unnecessary re-uploads and reducing continuous integration expenses, as highlighted in the rebase detection feature.

Commit-Driven Configuration

Automatically sets reviewers, labels, and draft status from commit messages using tags such as 'Reviewers:' and 'Labels:', streamlining PR setup without manual intervention.

Enhanced Review Navigation

Inserts auto-updating review graphs and patchsets tables into PRs, making it easier to track dependencies and change history, as demonstrated in the README examples.

Fork Workflow Support

Configurable to push to a fork while creating PRs in the main repository, ideal for open-source contributions where direct push access is limited.

Cons

Git Version Lock-In

Requires Git 2.43 or higher, which may necessitate upgrades and isn't compatible with older systems, as stated in the compatibility section, potentially blocking adoption in legacy environments.

Platform Limitations

Primarily tested on Linux and OSX with 'limited testing' on Windows, and tightly integrated with GitHub, excluding other Git hosts like GitLab or Bitbucket without custom modifications.

Setup Complexity

Involves configuring GitHub OAuth tokens and understanding commit tag syntax, which can be a barrier for quick adoption, especially for teams not familiar with stacked diff workflows.

Configuration Overhead

Highly configurable with flags and config files, which might overwhelm users seeking simplicity, as noted in the 'Configuring revup' section where every flag is also a config option.

Frequently Asked Questions

Related Projects

lobe-chat

🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.

Stars80,753

Forks15,687

Last commit17 hours ago

nerd-fonts

Iconic font aggregator, collection, & patcher. 3,600+ icons, 50+ patched fonts: Hack, Source Code Pro, more. Glyph collections: Font Awesome, Material Design Icons, Octicons, & more

Stars63,815

Forks3,930

Last commit2 days ago

sniffnet

Comfortably monitor your Internet traffic 🕵️‍♂️

Stars40,125

Forks1,779

Last commit19 hours ago

httpie

🥧 HTTPie CLI — modern, user-friendly command-line HTTP client for the API era. JSON support, colors, sessions, downloads, plugins & more.

Stars38,334

Forks3,974

Last commit1 year ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub