---
url: /mod/gt.md
---
# x gt

Manage Gitee work from the command line


::: tip
Get Gitee access token: https://gitee.com/profile/personal_access_tokens
- Interactive env use `x gt init` to initialize configuration. The configure will be saved locally.
- Run command `x gt --cfg token=<token>` to add access token.
:::


## Examples

Get current user information

```sh
x gt user info
```

Interactive UI show current user repositories

```sh
x gt repo ls
```
## Introduction



The gt module is a lightweight and efficient way to manage Gitee workflows, created by the x-cmd team by wrapping the Gitee CLI module using Shell and AWK and making use of the Gitee API.


- As one of the modules within x-cmd, the gt module offers out-of-the-box functionality and user-friendly command-line auto-completion.
- The design of gt module commands follows the principles of the x-cmd CLI, ensuring consistency with other x-cmd CLI tools.
- Utilizing the x-cmd TUI system, it provides a consistent and user-friendly command-line interactive interface.

## Usage

```sh
x gt [OPTIONS] [FLAGS] [SUB_COMMAND]
```

## Options

| Name, Shorthand | Default | Description |
| ------- | ------- | ------- |
| `--config` &lt;path&gt; |  | The path of the configure file used by the current command |
| `--profile` &lt;name&gt; |  | The name of the configure profile used by the current command |


## Flags

| Name, Shorthand | Description |
| ------- | ------- |
| `--cur` | current session default value management |
| `--cfg` | manage configuration for gt |


## Sub Commands

| Name | Description |
| ------- | ------- |
| [x gt repo](/mod/gt/repo.md) | repository management |
| [x gt user](/mod/gt/user.md) | user management |
| [x gt org](/mod/gt/org.md) | organization management |
| [x gt enterprise](/mod/gt/enterprise.md) | enterprise management |
| [x gt issue](/mod/gt/issue.md) | issue management |
| [x gt pr](/mod/gt/pr.md) | pull request management |
| [x gt notification](/mod/gt/notification.md) | notification management |
| [x gt codeurl](/mod/gt/codeurl.md) | Get Gitee source url |
| [x gt avatar](/mod/gt/avatar.md) | user addressbook management |
| [x gt init](/mod/gt/init.md) | Initialize the configuration using interactive mode |
| [x gt cl](/mod/gt/cl.md) | shortcut for `x gt repo clone` |