# Install the TestVibe GitHub App

TestVibe uses a GitHub App installation to work with repositories. The installation controls which accounts, organizations, and repositories TestVibe can see and use.

You may install the app for a personal account, an organization, or both, depending on where your testing repository lives.

## Why The GitHub App Is Needed

TestVibe uses GitHub App access to:

| Capability                   | Why TestVibe needs it                                            |
| ---------------------------- | ---------------------------------------------------------------- |
| List repositories            | So you can choose the repository for the workspace.              |
| Read test files              | So the Test Suite can show existing features and generated code. |
| Write generated files        | So AI generation can save feature files and Playwright tests.    |
| Manage workflow assets       | So the repository can run TestVibe workflows.                    |
| Read workflow status         | So TestVibe can show live generation and run progress.           |
| Manage secrets and variables | So repository settings can support generation and runs.          |

For a broader permissions explanation, see [GitHub permissions overview](/reference/github-permissions-overview.md).

## Install The App

1. Sign in to TestVibe with GitHub.
2. When prompted to choose an installation, select the account or organization that owns your repository.
3. If the TestVibe GitHub App is not installed there yet, choose the option to manage or install accounts.
4. In GitHub, choose whether TestVibe can access all repositories or only selected repositories.
5. Confirm the installation.
6. Return to TestVibe and refresh the installation or repository list.

If you only want TestVibe to work with specific repositories, choose selected repositories during installation and add more later when needed.

## Update Repository Access

If a repository is missing from TestVibe:

1. Open the TestVibe GitHub App installation settings in GitHub.
2. Add the repository to the installation.
3. Save the GitHub settings.
4. Return to TestVibe and refresh.
5. Select the installation, team, and repository again.

GitHub organization policies may require an owner or administrator to approve the installation or repository access change.

## Personal Accounts And Organizations

| Account type           | What to expect                                                                               |
| ---------------------- | -------------------------------------------------------------------------------------------- |
| Personal account       | You can usually install the app for repositories you own.                                    |
| Organization           | An organization owner may need to approve installation, repository access, or runner access. |
| Team-scoped repository | You may also need to choose the team context after selecting the installation.               |

## Next

After the app is installed, continue to [Choose a repository](/workspace/choose-repository.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/workspace/install-github-app.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.