Connecting a Codebase

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

Link Your GitHub Account

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

GitHub App Installation

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.

Connect Repositories

Press Add Repository, then use the dropdown in the dialog to search for and select the repository you want to connect to the project.

If the repository does not appear, use Manage GitHub Access to open GitHub and grant the 8090 Software Factory GitHub App access to it.

After you select and confirm a repository, indexing begins automatically. The agent can access the repository’s code after approximately 5–10 minutes.

Automatic Reindexing

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 manually reindex from a repository row’s actions menu.

To opt in to automated drift analysis after indexing—comparing Blueprints and Requirements with code—enable Code Analysis under Project Overview → Settings → Agent Hooks.

Removing a Codebase Connection

You can remove a codebase connection at any time from the Codebase tab by selecting Unlink on a repository row. Unlinking removes the repository from this project only; indexed data and the GitHub App installation are not deleted. You can add the connection again later.