# gt: General Translation CLI tool: Global options
URL: https://generaltranslation.com/en-GB/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 behaviour 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 behaviour. It does not change package versions or translation behaviour.

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

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

Suppresses banners, progress indicators 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 information, 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.*