Documentation · Getting started

Connect a repository

CogniForge delivers code into a Git repository you own. For a greenfield project, start with a fresh, empty repository — the platform makes the first commit itself.

1Create the repository and an access token

  • On GitHub, create a new empty repository (no README needed) under your account or organization.
  • Create a fine-grained personal access token with access to that repository and permissions for Contents (read/write) and Pull requests (read/write).

2Connect it in CogniForge

In your project, open Repositories → Connect repository, paste the repository URL and the token. The token is encrypted at rest and used for exactly three things: cloning and pushing branches, opening pull requests, and reading PR/CI status.

3What happens next — indexing

The platform clones the repository and builds its knowledge index: every file, symbol, and import relationship, plus semantic embeddings — this is how the AI finds and reuses existing code instead of reinventing it. The index then updates incrementally: within seconds when a ticket's pull request merges, and within a couple of minutes for any other push straight to the default branch (a background check, not a webhook — see Getting started end-to-end for why). Click Sync on the repository if you don't want to wait.

You can watch indexing status and explore what was indexed under Knowledge graph in the project sidebar.
Connect a repository — CogniForge Docs