Prerequisites
- A Modelcode account (sign up at modelcode.ai)
- A GitHub account (personal or organization)
- At least one repository you want to work with
How It Works
Modelcode uses two separate GitHub integrations:- Sign-in with GitHub — You can sign in to Modelcode using your GitHub account. This is handled through our identity provider and is used purely for authentication.
- GitHub App for repository access — To access your repositories, you install the Modelcode GitHub App. This grants Modelcode read access to the repositories you select.
Installing the GitHub App
Step 1: Navigate to the Projects Page
- Sign in to modelcode.ai
- Go to the Projects page
- If you haven’t connected GitHub yet, you’ll see a Connect GitHub button
Step 2: Install the GitHub App
- Click Connect GitHub
- You’ll be redirected to GitHub to install the Modelcode GitHub App
- Choose which account or organization to install it on
- Select which repositories Modelcode can access:
- All repositories — Grants access to every repo in your account or organization
- Only select repositories — Pick specific repos
Step 3: Return to Modelcode
After installing the GitHub App on GitHub, you’ll be redirected back to Modelcode. The connection is established automatically. You can now create projects using your connected repositories.Creating a Project with a Connected Repository
Once the GitHub App is installed:- Click Create Project on the Projects page
- In the repository dropdown, select from your connected repositories
- Choose a default branch for the project
- Optionally define a feature branch name
- Click Create Project
Managing Repository Access
Adding More Repositories
To grant Modelcode access to additional repositories:- From the Projects page or the Create Project modal, click Connect Repositories
- You’ll be taken to GitHub’s app installation settings
- Add the repositories you want
- Return to Modelcode — the new repos will appear in the dropdown
- Go to GitHub Settings → Applications
- Find the Modelcode app
- Click Configure
- Add repositories to the selected list
Removing Repository Access
To revoke access to specific repositories:- Go to GitHub Settings → Applications
- Find the Modelcode app
- Click Configure
- Remove repositories from the selected list
Uninstalling the GitHub App
To completely disconnect Modelcode from your GitHub account:- Go to GitHub Settings → Applications
- Find the Modelcode app
- Click Uninstall
Uninstalling the GitHub App does not delete any projects you’ve already created in Modelcode, but Modelcode will no longer be able to access your repositories.
Troubleshooting
”GitHub connection failed”
If the installation flow doesn’t complete:- Ensure you’re signed in to the correct GitHub account
- Check that your browser allows redirects from github.com
- Clear your browser cookies and try again
- If using an organization, ensure you have permission to install GitHub Apps
”Repository not showing up”
If you can’t see a repository in the Create Project dropdown:- Click Connect Repositories in the dropdown to open your GitHub App settings
- Verify the repository is in the selected list
- Go to GitHub Settings → Applications and confirm Modelcode has access
- Ensure the repository hasn’t already been added to another project
”No Repositories Found”
If Modelcode says your GitHub is connected but no repositories are available:- Your GitHub App installation may not have any repositories selected
- Click Connect Repositories to open the GitHub App configuration
- Select the repositories you want to use
”Insufficient permissions”
If you get a permissions error:- For organization repos, ensure an org admin has approved the GitHub App installation
- Verify you have the necessary permissions on the repository in GitHub
- Try clicking Connect Repositories to re-open the GitHub App configuration
Next Steps
- Quickstart — Create your first migration project
- Define Modernization Goals — Write effective goals for your migration
- Understanding Instructions — Learn how to review and approve your migration plan