Connecting a Codebase

Connecting your repositories allows Software Factory to read and index the code via a GitHub App. This enables the agent to search for and read the code in your repositories.

Before connecting a repository, open your project in Software Factory and link your GitHub account from the Project Overview → Codebase tab. Software Factory uses this to verify that your GitHub permissions match the repositories you can connect.

The 8090 Software Factory GitHub App must be installed for your repository before you can connect it. The app provides secure, read-only access to the repositories you select.

Open Project Overview → Codebase. If the app is not yet installed, click Install GitHub App, choose the GitHub organization or account, and select which repositories the app can access. After installation, you will be redirected to Software Factory to finish setup.

To connect a new repository, press the Add Repository button and use the dropdown in the modal to search for and select the repository that you would like to connect to your project. If you do not see the repository that you would like to index in the list, then you can use the Manage Github Access button to navigate to GitHub and provide the 8090 Software Factory GitHub app access to your repository.

Once you've selected a repository from the dropdown and confirmed your selection, indexing will begin automatically. After 5-10 minutes, the agent will be able to access the code in that repository.

Whenever code is pushed to the indexed branch, a webhook triggers reindexing to keep Software Factory up to date without manual action. You can also reindex manually from a repository row’s actions menu.

To opt in to automated drift analysis after indexing (blueprints and requirements vs. code), enable Code Analysis under Project Overview → Settings → Agent Hooks.

A codebase connection can be removed at any time from the Codebase tab (Unlink on a repository row). Unlinking removes the repository from this project only; indexed data and the GitHub App installation are not deleted. The connection can be re-added later.