Setting up your own Custom Workflows on One Codex is made easier when you can connect directly to your GitHub repositories. We now support connecting your GitHub account with your One Codex account.

As an organization owner or admin, you can integrate One Codex with GitHub from your settings page (click your name at the top-right of the One Codex site, and choose Settings). Towards the bottom of your settings page, you'll see a section for GitHub Integration.

There are two ways to connect your One Codex account to GitHub; either via our GitHub App, or via a GitHub Personal Access Token.

One Codex has developed a GitHub app, which an organization owner or admin can install on behalf of all organization members. If installed, the GitHub app takes precedence over individual Personal Access Tokens. Clicking "Install One Codex GitHub App" takes you to GitHub. Once logged in, you can choose which GitHub organization(s) you wish to install the app for. Once you've selected you organization, you will be able to choose whether to provide access to all repositories, or only selected repositories.

If you don't want to connect GitHub for all members in your One Codex organization, you can instead choose to connect via your own Personal Access Token. Note that if the GitHub integration app is enabled, you will not be able to provide a Personal Access Token, as the app integration takes precedence.

To generate a Personal Access Token, you will need to follow these GitHub steps.

Integrating your GitHub account with your One Codex account allows you to access your GitHub repositories for your Custom Workflows.

If you have connected via the GitHub app, returning to your settings page, you will see a button to remove the GitHub App integration. Note that this does not uninstall the app from GitHub. You can uninstall from GitHub by visiting your GitHub installations page.

If you have provided a GitHub Personal Access Token, you will see an option to either Update or Remove your Personal Access Token from your One Codex settings page. You can also delete your Personal Access Token within GitHub by following these steps.