# Shell diagnostics

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

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

## Runtime errors

| Code | What happened |
| --- | --- |
| [`SHELL_R0001`](https://vitehub.dev/docs/shell/diagnostics/shell_r0001) | Shell analysis timed out after \<timeoutMs\>ms. |
| [`SHELL_R0002`](https://vitehub.dev/docs/shell/diagnostics/shell_r0002) | Shell analysis timed out after \<timeoutMs\>ms. |
| [`SHELL_R0003`](https://vitehub.dev/docs/shell/diagnostics/shell_r0003) | See the page of the code. |
| [`SHELL_R0004`](https://vitehub.dev/docs/shell/diagnostics/shell_r0004) | See the page of the code. |
| [`SHELL_R0007`](https://vitehub.dev/docs/shell/diagnostics/shell_r0007) | Controlled curl accepts exactly one URL. |
| [`SHELL_R0008`](https://vitehub.dev/docs/shell/diagnostics/shell_r0008) | See the page of the code. |
| [`SHELL_R0009`](https://vitehub.dev/docs/shell/diagnostics/shell_r0009) | Shell driver does not support long-running processes. |
| [`SHELL_R0010`](https://vitehub.dev/docs/shell/diagnostics/shell_r0010) | Shell session process budget exhausted after \<maxProcesses\> processes. |
| [`SHELL_R0011`](https://vitehub.dev/docs/shell/diagnostics/shell_r0011) | See the page of the code. |
| [`SHELL_R0012`](https://vitehub.dev/docs/shell/diagnostics/shell_r0012) | See the page of the code. |
| [`SHELL_R0013`](https://vitehub.dev/docs/shell/diagnostics/shell_r0013) | Workspace path escapes the workspace root: "\<path\>". |
| [`SHELL_R0014`](https://vitehub.dev/docs/shell/diagnostics/shell_r0014) | Workspace filesystem is read-only. |
| [`SHELL_R0015`](https://vitehub.dev/docs/shell/diagnostics/shell_r0015) | chmod is not supported by the workspace filesystem. |
| [`SHELL_R0016`](https://vitehub.dev/docs/shell/diagnostics/shell_r0016) | symlink is not supported by the workspace filesystem. |
| [`SHELL_R0017`](https://vitehub.dev/docs/shell/diagnostics/shell_r0017) | link is not supported by the workspace filesystem. |
| [`SHELL_R0018`](https://vitehub.dev/docs/shell/diagnostics/shell_r0018) | readlink is not supported by the workspace filesystem. |
| [`SHELL_R0019`](https://vitehub.dev/docs/shell/diagnostics/shell_r0019) | utimes is not supported by the workspace filesystem. |
| [`SHELL_R0020`](https://vitehub.dev/docs/shell/diagnostics/shell_r0020) | Workspace root is not a valid mutation target. |
| [`SHELL_R0021`](https://vitehub.dev/docs/shell/diagnostics/shell_r0021) | Workspace path escapes the workspace root: "\<path\>". |
| [`SHELL_R0022`](https://vitehub.dev/docs/shell/diagnostics/shell_r0022) | Cannot move Workspace path "\<src\>" into itself, "\<dest\>". |
| [`SHELL_R0023`](https://vitehub.dev/docs/shell/diagnostics/shell_r0023) | Workspace directory already exists: "\<path\>". |
| [`SHELL_R0024`](https://vitehub.dev/docs/shell/diagnostics/shell_r0024) | Shell process start timed out after \<timeout\>ms. |

## Named errors

| Code | What happened |
| --- | --- |
| [`SHELL_SH_SYNTAX_WASM_UNAVAILABLE`](https://vitehub.dev/docs/shell/diagnostics/shell_sh_syntax_wasm_unavailable) | sh-syntax cannot load its WebAssembly parser on this host. |

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

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

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