# Forge diagnostics

<!-- Generated by docs/modules/diagnostics from the package catalogs. Write a guide in docs/diagnostics/<CODE>.md instead of editing this file. -->

Each Forge error has a stable `code`. Its `docs` link opens the page of that code. This page lists all 16 codes, and [All diagnostics](https://vitehub.dev/docs/reference/diagnostics) lists every primitive.

## Runtime errors

| Code | What happened |
| --- | --- |
| [`FORGE_APP_NOT_INSTALLED`](https://vitehub.dev/docs/forge/diagnostics/forge_app_not_installed) | The GitHub App is not installed on \<repository\>. |
| [`FORGE_R0001`](https://vitehub.dev/docs/forge/diagnostics/forge_r0001) | GitHub App is not installed for \<repository\>. |
| [`FORGE_R0002`](https://vitehub.dev/docs/forge/diagnostics/forge_r0002) | Repository archives are not supported for \<forge\>. |
| [`FORGE_R0003`](https://vitehub.dev/docs/forge/diagnostics/forge_r0003) | Forge base URL \<baseUrl\> must use http or https. |
| [`FORGE_R0004`](https://vitehub.dev/docs/forge/diagnostics/forge_r0004) | Reading a blob by sha is not supported for \<forge\>. |
| [`FORGE_R0005`](https://vitehub.dev/docs/forge/diagnostics/forge_r0005) | Git file modes are not supported for \<forge\>. |
| [`FORGE_R0006`](https://vitehub.dev/docs/forge/diagnostics/forge_r0006) | \<operation\> is available only on GitHub. \<forge\> has no equivalent. |
| [`FORGE_R0007`](https://vitehub.dev/docs/forge/diagnostics/forge_r0007) | See the page of the code. |
| [`FORGE_R0009`](https://vitehub.dev/docs/forge/diagnostics/forge_r0009) | Only a pull request with a number can merge past branch rules. |
| [`FORGE_REQUEST_FAILED`](https://vitehub.dev/docs/forge/diagnostics/forge_request_failed) | \<operation\> failed with HTTP \<status\>. |

## Configuration errors

| Code | What happened |
| --- | --- |
| [`FORGE_INVALID_ENV`](https://vitehub.dev/docs/forge/diagnostics/forge_invalid_env) | \<name\> \<problem\>. |
| [`FORGE_MISSING_ENV`](https://vitehub.dev/docs/forge/diagnostics/forge_missing_env) | The \<forge\> Forge has no credentials. It reads \<names\>. |
| [`FORGE_MISSING_INSTALLATION`](https://vitehub.dev/docs/forge/diagnostics/forge_missing_installation) | The GitHub App needs an installation. The call has no `repository`, and VITEHUB_GITHUB_INSTALLATION_ID is not set. |
| [`FORGE_NOT_APP`](https://vitehub.dev/docs/forge/diagnostics/forge_not_app) | `forge.app()` needs a GitHub App, and this Forge uses a token. |

## Named errors

| Code | What happened |
| --- | --- |
| [`FORGE_RESPONSE_INVALID`](https://vitehub.dev/docs/forge/diagnostics/forge_response_invalid) | See the page of the code. |
| [`FORGE_UNSUPPORTED`](https://vitehub.dev/docs/forge/diagnostics/forge_unsupported) | Unsupported Forge. |

<!-- vitehub-docs:section-links -->
## In this section

- [Overview](https://vitehub.dev/raw/docs/forge.md)
- [Get started](https://vitehub.dev/raw/docs/forge/get-started.md)
- [Configure](https://vitehub.dev/raw/docs/forge/configure.md)
- [Server API](https://vitehub.dev/raw/docs/forge/server-api.md)
- [Limits and errors](https://vitehub.dev/raw/docs/forge/limits-and-errors.md)

All pages: [llms.txt](https://vitehub.dev/llms.txt)
