When you connect GitHub, Grove reads your code. It plans from what you've already built, and checks the code against each outcome when work ships. Grove only reads your code. It never changes it.
Only workspace admins can connect GitHub. If you're not an admin, ask one to do it.
What Grove asks for
GitHub permission | Access |
Contents (code) | Read |
Metadata | Read |
Commit statuses | Read |
Pull requests | Read |
Issues | Read and write |
Grove doesn't get write access to your code. For what Grove does with each permission, see How Grove uses your code: permissions, sandbox, read-only access.
Connect
Open the account menu, then Workspace settings.
Under Integrations, click GitHub.
Click Connect GitHub.
GitHub opens. Pick the organization, or your personal account.
Pick the repositories Grove can read: all of them, or only some. Pick only the ones you want Grove to see.
Confirm on GitHub. You come back to Settings › GitHub.
You can also start from:
The setup checklist on the Queue: click Connect GitHub in Connect your code.
A project's Delivery tab: click Connect GitHub.
After you connect
Settings › GitHub shows Connected organizations. Each organization shows how many repositories Grove can read, and lists them.
Grove starts copying your repositories right away. It may take a few minutes before Grove can use all your code.
To connect another GitHub organization, click Connect GitHub again, under Connect another organization.
If GitHub needs an owner's approval
If you aren't an owner of the GitHub organization, GitHub asks an owner to approve the Grove app. Grove shows: "A GitHub organization owner needs to approve the Grove app. Once approved, connect again." When the owner approves, click Connect GitHub again.
Other messages
Message | What to do |
"App installed, but no repositories were selected." | Go back to GitHub, and give Grove access to at least one repository. |
"You do not have access to manage this workspace's GitHub connection." | Ask a workspace admin to connect GitHub. |
"We couldn't complete the connection." | Try connecting again. |
Skip for now
On the setup checklist, you can click Skip in Connect your code. Grove still plans without your code, but it can't check what ships. You can connect GitHub later in Settings › GitHub.