# gt: General Translation CLI tool: Global options
URL: https://generaltranslation.com/en-US/docs/cli/reference/global-options.mdx
---

title: Global options
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) | Show only warnings and errors. | `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 output. Warnings and errors remain visible.

When `GT_LOG_FORMAT=json`, 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 output, 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
```

## 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. Use `json` for machine-readable logs. | `default`, `json` | `default` |
| `GT_LOG_FILE` | Write a full log to this file path. | File path | — |

`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
```

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