# gt: General Translation CLI tool: Global options
URL: https://generaltranslation.com/en-US/docs/cli/reference/global-options.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Control output, compatibility checks, and command help across the General Translation CLI. API reference for global CLI options.

Global options apply to the `gt` command and its subcommands. The `--quiet` option can appear before or after a subcommand.

## Overview [#overview]

```bash
npx gt [global options] <command>
```

| Option | Description | Type | Optional | Default |
| --- | --- | --- | --- | --- |
| [`--skip-version-check`](#skip-version-check) | Skip the monorepo package-version consistency check. | `boolean` | Yes | `false` |
| [`--suppress-id-compatibility-warning`](#suppress-id-warning) | Hide the React package ID compatibility warning. | `boolean` | Yes | `false` |
| [`-q, --quiet`](#quiet) | Suppress informational logs. | `boolean` | Yes | `false` |
| [`-h, --help`](#help) | Display help for the current command. | `boolean` | Yes | `false` |

## `--skip-version-check` [#skip-version-check]

**Type** `boolean` · **Optional** · **Default** `false`

Skips the consistency check for General Translation packages in a monorepo. Other validation still runs. To persist this behavior for every command, set `"skipVersionCheck": true` in `gt.config.json`.

## `--suppress-id-compatibility-warning` [#suppress-id-warning]

**Type** `boolean` · **Optional** · **Default** `false`

Hides the warning about incompatible React package ID behavior. It does not change package versions or translation behavior.

## `-q, --quiet` [#quiet]

**Type** `boolean` · **Optional** · **Default** `false`

Suppresses banners, progress spinners, and informational logs. Warnings and errors remain visible. This does not suppress command data: [`gt api-key create`](/docs/cli/reference/commands/api-key-create) still writes the new secret to stdout.

When `GT_LOG_FORMAT` is `json` or `agent`, quiet mode raises the console log level to `warn`. It does not lower a more restrictive `GT_LOG_LEVEL`, such as `error`.

It also works on nested subcommands, in any position.

```bash
npx gt translate --quiet
npx gt git setup --quiet
```

*Note: Quiet mode suppresses logs, not interaction. Prompts still run, so pass the options a command needs when running it non-interactively.*

## `-h, --help` [#help]

**Type** `boolean` · **Optional** · **Default** `false`

Displays usage, options, and available subcommands without running the command.

```bash
npx gt translate --help
```

## API environment variable [#api-url]

`GT_API_URL` sets the API origin for every command. It overrides [`baseUrl`](/docs/cli/reference/config#base-url) in `gt.config.json`; when neither is set, the CLI uses `https://api.gtx.dev`. An empty value is treated as unset.

```bash
GT_API_URL=https://api.example.com npx gt translate
```

## Logging environment variables [#logging]

These environment variables configure CLI logging. They apply to every command.

| Variable | Description | Values | Default |
| --- | --- | --- | --- |
| `GT_LOG_LEVEL` | Minimum level printed to the console. | `debug`, `info`, `warn`, `error` | `info` |
| `GT_LOG_FORMAT` | Console output format. | `default`, `json`, `agent` | `default` in a terminal; `agent` in CI or when stdout is not a terminal |
| `GT_LOG_FILE` | Write a full log to this file path. | File path | — |

`default` is the interactive display, including the ASCII banner and the CLI version line. `json` writes one JSON log object per line. `agent` writes plain timestamped `LEVEL: message` lines, with no color and no banner. The banner is also omitted for `json`.

Since `gt` 2.26.10, an unset `GT_LOG_FORMAT` uses `agent` when stdout is not a terminal, and when `CI` is nonempty and is neither `false` nor `0`. Set `GT_LOG_FORMAT=default` to keep the interactive display in those environments.

`GT_LOG_FILE` is an explicit debug-capture opt-in, and [`--quiet`](#quiet) does not affect it. Silence the console and still keep a complete log on disk:

```bash
GT_LOG_FILE=gt.log npx gt translate --quiet
```

For [`gt api-key create`](/docs/cli/reference/commands/api-key-create), diagnostics go to stderr. The secret is raw stdout even with JSON logging and is never captured by `GT_LOG_FILE`.

*Note: An invalid `GT_LOG_FORMAT` or `GT_LOG_LEVEL` value stops the command with an error.*

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.