# Select an installation, team, and repository

After you sign in, TestVibe needs to know which GitHub repository you want to work with.

Depending on your access, you may be asked to choose a GitHub App installation, a team, and then a repository. If you only have one option, TestVibe may skip some of these screens.

## What You Are Choosing

| Choice       | What it means                                                                    |
| ------------ | -------------------------------------------------------------------------------- |
| Installation | The GitHub App installation that gives TestVibe access to selected repositories. |
| Team         | The organization or team context for the repositories you can use.               |
| Repository   | The GitHub repository where TestVibe will store and run tests.                   |

Choose the repository that contains the application test assets, or the repository where you want TestVibe to create them.

## Steps

1. Select the GitHub App installation for the account or organization you want to use.
2. If prompted, select the team that owns or has access to the repository.
3. Select the repository you want to test.
4. Wait for TestVibe to load the workspace.

When the workspace finishes loading, you should be ready to create or connect a project.

## Choosing The Right Repository

Use the repository where you want test files and workflow configuration to live.

If you are testing a separate application repository, choose the repository your team expects to own the tests. Some teams keep tests beside the application. Other teams use a dedicated test repository.

The important part is that your team knows where generated files will be stored and where test runs will happen.

## If The Repository Is Missing

Common causes:

* the TestVibe GitHub App is not installed for that repository
* your GitHub user does not have access to the repository
* you selected the wrong installation or team
* the repository was recently added and the page needs to be refreshed

See [Missing repositories](/troubleshooting/missing-repositories.md) for the recovery steps.

## Next

Continue to [Create or connect a project](/quickstart/create-or-connect-project.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.testvibe.com/quickstart/select-installation-team-repository.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
