MediaMetz/gemini-cli
1
0
Fork 0
mirror of https://github.com/google-gemini/gemini-cli.git synced 2026-05-15 14:23:02 -07:00
Code Issues Packages Projects Releases Wiki Activity

Fix up exit code table

Browse Source
This commit is contained in:
Chris Williams
2026-03-20 12:15:54 -07:00
parent 625ff6b27b
commit 1eb181587e
1 changed files with 9 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/cli/headless.md
+9 -5
View File
@@ -36,18 +36,22 @@ Returns a stream of newline-delimited JSON (JSONL) events.
## Exit codes
The Gemini CLI uses specific exit codes to indicate the reason for termination.
This is especially useful for headless scripting and automation:
Gemini CLI uses the following exit codes to indicate why the tool terminated
unexpectedly. You can use these codes to handle errors in scripts and automation
workflows.
| Exit Code | Error Type | Description |
| Exit code | Error type | Description |
| --------- | -------------------------- | --------------------------------------------------------------------------------------------------- |
| 0 | `Success` | Success. |
| 1 | `GeneralError` | General error or API failure. |
| 41 | `FatalAuthenticationError` | An error occurred during the authentication process. |
| 42 | `FatalInputError` | Invalid or missing input was provided to the CLI. (non-interactive mode only) |
| 44 | `FatalSandboxError` | An error occurred with the sandboxing environment (e.g., Docker, Podman, or Seatbelt). |
| 52 | `FatalConfigError` | A configuration file (`settings.json`) is invalid or contains errors. |
| 53 | `FatalTurnLimitedError` | The maximum number of conversational turns for the session was reached. (non-interactive mode only) |
| 54 | `FatalToolExecutionError` | An error occurred during tool execution. |
| 130 | `FatalCancellationError` | The operation was canceled by the user (e.g., SIGINT). |
Exit code 0 indicates that Gemini CLI finished successfully. Exit code 1
indicates a general error or API failure occurred.
## Next steps