Authenticating the CLI
If you want to use Graphite to create or update pull requests in GitHub for the branches in your stack using gt stack submit, you'll need to authenticate the CLI with your GitHub account. See Privacy & Security to understand what GitHub permissions Graphite requires.
Authenticating the Graphite CLI is easy:
Sign into https://app.graphite.dev/activate with your GitHub account
gt auth --token <your_cli_auth_token>command shown (your CLI auth token will be pre-filled)
Paste & run it in your terminal
Once you've authenticated the CLI, you should be able to run
gt stack submit to create or update pull requests in GitHub for every branch in your stack.
Your privacy & security are top priorities - Graphite is architected to ask for the minimum set of permissions necessary within the constraints of GitHub's API. Learn more our GitHub integration here.
Depending on your organization's settings, you may see the following error when you run
gt stack submit:
"Third-party access" > "Third-party application access policy" is set to"Access restricted" (GitHub default) in your organization's settings,meaning that Graphite cannot submit PRs on your behalf using your standardOAuth token.
If you still want to use
gt stack submit, you can add a GitHub Personal Access Token (these are intended to give command line tools limited access to work with your account) - just follow these instructions to enable access.
Once you've added your Personal Access Token to the web dashboard, the Graphite CLI will automatically pick it up (you don't need to run
gt auth again), and
gt stack submit should work correctly.