# gt: General Translation CLI tool: Translation CLI
URL: https://generaltranslation.com/en-US/docs/cli.mdx
---
title: Translation CLI
description: Set up and translate your project with the General Translation command line tool
---

## Overview

The General Translation CLI tool (`gt`) lets you set up internationalization and automatically translate your project into any of the [supported languages](/docs/platform/supported-locales).

It works with [`gt-next`](/docs/next), [`gt-react`](/docs/react), [`gt-react-native`](/docs/react-native), and third-party i18n libraries like [next-intl](https://next-intl.dev/) and [i18next](https://react.i18next.com/). You can also use it to translate standalone files (JSON, MDX, HTML, and more).

## Quickstart

### 1. Set up your project

```bash
npx gt@latest
```

This runs the setup wizard, which will:
- Install the necessary dependencies (e.g., `gt-next` or `gt-react`)
- Configure your framework (Next.js plugin, React provider, etc.)
- Create a `gt.config.json` with your locales and file settings
- Generate API credentials

### 2. Translate

```bash
npx gt translate
```

This translates your project using the General Translation API. Run it in your CI/CD pipeline **before** building for production.

<Callout type="info">
  **Note:** A production API key is required for the `translate` command. The setup wizard can generate one for you, or get one at [generaltranslation.com](https://generaltranslation.com).
</Callout>

That's it — two commands to go from a single-language project to a fully translated one.

## Commands

| Command | Description |
| --- | --- |
| [`npx gt@latest`](/docs/cli/init) | Run the setup wizard. Installs dependencies, configures your project, and generates credentials. |
| [`npx gt translate`](/docs/cli/translate) | Translate your project via the GT API. |
| [`npx gt configure`](/docs/cli/configure) | Update your project's GT settings (`gt.config.json`). |
| [`npx gt auth`](/docs/cli/auth) | Generate or refresh API credentials. |
| [`npx gt generate`](/docs/cli/generate) | Generate a translation data JSON file for standalone use. |
| [`npx gt upload`](/docs/cli/upload) | Upload source files and translations to the GT platform. |
| [`npx gt enqueue`](/docs/cli/enqueue) | Enqueue files for translation without downloading results. |
| [`npx gt download`](/docs/cli/download) | Download translations that were previously enqueued or staged. |
| [`npx gt stage`](/docs/cli/stage) | Stage translations for human review before publishing. |
| [`npx gt save-local`](/docs/cli/save-local) | Save local translation edits to the GT platform. |

## Guides

| Guide | Description |
| --- | --- |
| [Branching](/docs/cli/branching) | Track translations separately for different git branches. |
| [FAQs](/docs/cli/faqs) | Common questions about the CLI tool. |

## Supported formats

The CLI can translate files in a variety of formats:

[GT](/docs/cli/formats/gt) · [JSON](/docs/cli/formats/json) · [MDX](/docs/cli/formats/mdx) · [TypeScript/JavaScript](/docs/cli/formats/ts) · [YAML](/docs/cli/formats/yaml) · [HTML](/docs/cli/formats/html) · [Plain text](/docs/cli/formats/txt)