# gt: General Translation CLI tool: gt configure
URL: https://generaltranslation.com/en-GB/docs/cli/reference/commands/configure.mdx
---
title: gt configure
description: Create a General Translation gt.config.json file. API reference for the gt configure command.

---

Creates or updates a `gt.config.json` file at the root of your project. Unlike [`gt init`](/docs/cli/reference/commands/init), it does not install dependencies, alter your framework setup, or generate credentials — it only writes configuration.

The command prompts for missing locale settings and the file types you want to translate. It preserves valid existing locale and file settings. For a walkthrough of the resulting file, see [Configuring the CLI](/docs/cli/guides/configuring).

```bash
npx gt configure
```

## How it works [#how-it-works]

1. Reads existing configuration and prompts for missing default locale, target locales, and file types.
2. Writes `defaultLocale`, `locales`, and a `files` object without replacing unrelated file settings.

`configure` is the configuration step of the [`gt init`](/docs/cli/reference/commands/init) wizard. Run it on its own to create the config file without touching dependencies, framework setup, or credentials.

## Flags [#flags]

`configure` takes no command-specific flags — it is fully interactive and always writes to `gt.config.json` (or `src/gt.config.json` when that file already exists). The global `--skip-version-check` flag is accepted, as with any command.

## Example [#example]

```bash
# Write gt.config.json interactively
npx gt configure
```

## Other notes [#notes]

* In a monorepo, run `configure` from the specific app directory. The command stops without changing files when the current directory is a workspace root with `pnpm-workspace.yaml` or a `workspaces` field.
* Automatic configuration is not available for Electron applications.
* The generated `gt.config.json` includes your `defaultLocale`, `locales`, and a `files` object describing the content to translate. See the [configuration reference](/docs/cli/reference/config) for all available options.