Live streamJoin us for "State of code review 2024" on July 18thRegister today
Quick start
Get started using the Graphite VS Code extension to stack pull requests.

There are two ways to check out branch in the VS Code extension:

  1. Double-click the branch on the stack view

  2. Focus a branch (single-click a branch such that it has a blue outline) and click "check out" in the branch info panel

A checked out branch will be indicated by a blue background/a pointer on the left side of the stack view.

Focusing a branch allows you to see what's been changed in the branch without checking it out. To focus a branch, single-click the branch in the visualization such that it has a blue outline. Focusing a branch adjusts the branch info panel so that it shows the files touched by that branch.

Uncommitted changes are represented by a node labeled "uncommitted changes" on the stack view. To see your uncommitted changes in the extension, focus the "uncommitted changes" node as you would any other branch. The branch info panel will adjust to a staging environment with your local changes.

Toggling the checkbox near each file in the uncommitted changes panel will stage or unstage that file independently. Hovering over the file will give you the option to view the diff, or delete those changes.

There are additional options to "stage all," "unstage all," and "delete all changes."

After staging relevant changes, you can create a new branch by entering a commit message and clicking "create new branch."

To modify an existing branch, ensure you have the desired branch checked out, stage relevant changes, check the "modify <branch-name>" checkbox, and click "commit to the current branch."

When modifying a branch, you can either create a new commit on that branch, or modify the previous commit on that branch. You can set your preferred behavior in the extension's settings:

Note that if your preferred modify behavior is commit, you'll be prompted to enter a commit message before creating the commit. If the default behavior is amend, you won't be prompted to do so.

You can re-arrange branches by dragging them onto a new parent.

You can track branches onto a parent by clicking the "cloud" icon in the upper right hand corner of the extension. This is equivalent to the CLI's gt track and gt get commands.

Give your PR workflow
an upgrade today

Stack easier | Ship smaller | Review quicker

Or install our CLI.
Product Screenshot 1
Product Screenshot 2