Connect GitHub

Nexus Factory works directly with your GitHub repositories. It uses a per-user OAuth connection, so the factory acts as you: cloning your repos, pushing branches, and opening pull requests under your account.

Connect your account

  1. Open the dashboard and go to Settings.
  2. Click Connect GitHub.
  3. Authorize the Nexus Factory OAuth app. It requests repo and read:org scopes so it can read your organizations and open pull requests.
  4. You are redirected back to the dashboard, now connected.
Your code stays in your repositories. Nexus Factory does not host your source; it clones per task, works in an isolated container, pushes a branch, and opens a PR.

Submitting work from GitHub

Once connected, create an issue on a connected repository and add the factory label. The factory picks it up, plans the work, and returns a pull request referencing the issue.

Troubleshooting

  • Repo not found: ensure the repository is owned by (or shared with) the GitHub account you connected.
  • Permission errors: reconnect from Settings to refresh the OAuth grant.