Connect GitHub so Code can work on your repositories in Ysra's cloud — install the Ysra GitHub App, choose repositories, and remove access.

On this page

The GitHub connection is the Ysra GitHub App installed on your GitHub account or organisation, reaching only the repositories you choose. Connect it to run Code in Ysra’s cloud on a GitHub repository. This page covers connecting, what the connection allows, and removing it; Code on your computer doesn’t need it.

Why connect GitHub#

You want to Needs the GitHub connection?
Run a Code thread in Ysra’s cloud on a GitHub repository Yes: cloud threads work on a copy of a granted repository
Run Code on a folder on your computer (desktop app or CLI) No: it works on the folder with your own Git. See Commit and push
Search code, issues or pull requests from Ask Not available: the card says it is there “So Ask knows your repositories”, but Ask doesn’t search code, issues or pull requests

Connect#

Before you start: a GitHub account allowed to install apps on the account or organisation that owns the repositories.

Open the GitHub card#

In the web app, open Settings → Connectors and find the GitHub card under Sources. Choose Connect; the button shows “Opening GitHub…” while GitHub loads. A cloud thread’s Where list also offers Connect GitHub… when GitHub isn’t connected.

Choose the account and repositories on GitHub#

Pick the personal account or organisation to install the app on, and choose which repositories it may reach: all of them, or a selected list. GitHub shows the permissions before you confirm.

Check the card in Ysra#

Back in Ysra, you land on Integrations with “GitHub connected”. There is no second step: the card shows the connected account, which repositories are granted, the scopes, and the connection’s status. If connecting fails, the card says why, with Try again.

The repositories now appear under GitHub repositories in Code’s Where list. While they load, the list says “Your GitHub repositories are still loading.”; if they can't be read, it says so and you can try again.

What Ysra may do with it#

Action Needs your approval?
Read a granted repository and copy it to a cloud machine No: starting the thread is the request
Make changes on a branch of its own, starting from the default branch Once per thread: paid work in a thread needs a one-time OK
Open a pull request with the changes Yes: “Open a pull request?” → Open pull request
Deploy the repository (“Publish” in a repository thread) Yes: every deploy asks first. See Publish or Deploy
Change the default branch directly Never: the work always runs on a branch of its own
Reach a repository you didn’t grant Never
Sync GitHub into company search Never: GitHub isn’t synced

Change access or disconnect#

To Do this
Grant more repositories, or remove one On the GitHub card, choose Repositories on GitHub ↗. It opens the Ysra app’s settings on GitHub, where you pick the repositories. Ysra sees the change straight away
Disconnect GitHub from Ysra On the GitHub card, choose Disconnect. Ysra stops using the connection at once
Remove the Ysra app from GitHub entirely After Disconnect, uninstall the Ysra app on GitHub (from Repositories on GitHub ↗)

Disconnect says: “GitHub disconnected. The Ysra app stays installed on GitHub until you remove it there.” Connect again at any time with Connect.

If it doesn't work#

A repository is missing from the Where list#

Why: it isn’t granted to the Ysra app on GitHub, or its access was removed there.

What to do:

  1. Add the repository with Repositories on GitHub ↗ on the GitHub card.
  2. Reload Code and open Where again.
  3. To work on it without the cloud, open its folder on your computer in the desktop app or the CLI.

No repositories or environments are listed at all#

Why: cloud isn’t on for the account (no plan includes cloud), or GitHub isn’t connected.

What to do:

  1. Check the plan: cloud needs Starter or above. See Limits and costs.
  2. Connect GitHub as above.
YsraDocs