---
url: /mod/theme/feature.md
---
# x theme feature

Manage features of the current theme

## Sub Commands

| Name | Description |
| ------- | ------- |
| [x theme feature use](#x-theme-feature-use) | Set the global theme feature. If the terminal environment is not specified, the value of the default terminal environment will be changed. |
| [x theme feature try](#x-theme-feature-try) | Set the theme feature of the current terminal environment |
| [x theme feature reload](#x-theme-feature-reload) | Reload the feature configuration of the current environment |
| [x theme feature cat](#x-theme-feature-cat) | View the global feature config file |
| [x theme feature get](#x-theme-feature-get) | Get the value of the specified feature in the current environment |


### x theme feature use

Set the global theme feature. If the terminal environment is not specified, the value of the default terminal environment will be changed.



::: tip
When customizing a symbol topic, the format of the symbol is (<SEP><root symbol><SEP><user symbol><SEP><workspace symbol><SEP>), SEP can be any single character

  e.g. symbol --custom /$/$/%/
:::


- **Examples**:

Set the global theme feature to enable transient features by default

```sh
x theme feature use transient_enable always
```

Set the global theme feature to disable transient features by default

```sh
x theme feature use transient_enable never
```

- **Usage**:

```sh
x theme feature use [FLAGS] [SUB_COMMAND]
```

- **Flags**:


| Name, Shorthand | Description |
| ------- | ------- |
| `--apple` | Theme of Apple |
| `--iterm` | Theme of iterm |
| `--vscode` | Theme of vscode |
| `--windows` | Theme of windows terminal |
| `--gnome` | Theme of gnome |
| `--konsole` | Theme of konsole |
| `--kde` | Theme of kde |
| `--ide` | Theme of ide |
| `--default` | Theme of default |


- **Sub Commands**:


| Name | Description |
| ------- | ------- |
| [x theme feature use transient_enable](#x-theme-feature-use-transient-enable) | Enable transient feature |
| [x theme feature use transient_cwd](#x-theme-feature-use-transient-cwd) | Enable transient cwd feature, and there will be prompts in different directories. |
| [x theme feature use transient_time](#x-theme-feature-use-transient-time) | Enable transient cwd feature, and there will the time will be displayed in transient ps1 |
| [x theme feature use symbol](#x-theme-feature-use-symbol) | Select symbol feature |
| [x theme feature use emoji](#x-theme-feature-use-emoji) | Select emoji feature |
| [x theme feature use zshplugin](#x-theme-feature-use-zshplugin) | Load default zsh plugins (zsh-syntax-highlighting、zsh-autosuggestions、zsh-config) |
| [x theme feature use exectime](#x-theme-feature-use-exectime) | Record the execution time of the command, only part of the theme supports this feature |


### x theme feature use transient_enable

Enable transient feature


- **Usage**:

```sh
x theme feature use transient_enable <#1>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | Strategy<br>`always` &#124; `never` &#124; `auto` |


### x theme feature use transient_cwd

Enable transient cwd feature, and there will be prompts in different directories.


- **Usage**:

```sh
x theme feature use transient_cwd <#1>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | Strategy<br>`always` &#124; `never` &#124; `auto` |


### x theme feature use transient_time

Enable transient cwd feature, and there will the time will be displayed in transient ps1


- **Usage**:

```sh
x theme feature use transient_time <#1>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | Strategy<br>`always` &#124; `never` &#124; `auto` |


### x theme feature use symbol

Select symbol feature


- **Sub Commands**:


| Name | Description |
| ------- | ------- |
| [x theme feature use symbol --topic](#x-theme-feature-use-symbol-topic) | Select an existing symbol topic |
| [x theme feature use symbol --custom](#x-theme-feature-use-symbol-custom) | Custom symbol topic |


### x theme feature use symbol --topic

Select an existing symbol topic


- **Usage**:

```sh
x theme feature use symbol --topic|-t <#1>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | topic name<br>`byzantine` &#124; `sumer` &#124; `egypt` &#124; `china` &#124; `dao` ... |


### x theme feature use symbol --custom

Custom symbol topic


- **Usage**:

```sh
x theme feature use symbol --custom|-c <#1>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | symbol string |


### x theme feature use emoji

Select emoji feature


- **Examples**:

Use coffee emoji for the current theme

```sh
x theme feature try emoji ☕
```

Use curl to get weather emoji for the current theme

```sh
x theme feature try emoji "$( curl -s "wttr.in/?format=%c" )"
```

- **Usage**:

```sh
x theme feature use emoji [SUB_COMMAND] <#1>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | Custom emoji<br>`undefined` |


- **Sub Commands**:


| Name | Description |
| ------- | ------- |
| [x theme feature use emoji --topic](#x-theme-feature-use-emoji-topic) | Select an existing emoji topic |


### x theme feature use emoji --topic

Select an existing emoji topic


- **Usage**:

```sh
x theme feature use emoji --topic|-t <#1>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | topic name |


### x theme feature use zshplugin

Load default zsh plugins (zsh-syntax-highlighting、zsh-autosuggestions、zsh-config)


- **Usage**:

```sh
x theme feature use zshplugin <#1>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | Strategy<br>`always` &#124; `never` &#124; `auto` |


### x theme feature use exectime

Record the execution time of the command, only part of the theme supports this feature


- **Usage**:

```sh
x theme feature use exectime <#1>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | Strategy<br>`always` &#124; `never` &#124; `auto` |


### x theme feature try

Set the theme feature of the current terminal environment



::: tip
When customizing a symbol topic, the format of the symbol is (&lt;SEP&gt;&lt;root symbol&gt;&lt;SEP&gt;&lt;user symbol&gt;&lt;SEP&gt;&lt;workspace symbol&gt;&lt;SEP&gt;), SEP can be any single character

  e.g. symbol --custom /$/$/%/
:::


- **Examples**:

Set the theme of the current terminal environment. The transient feature is enabled by default.

```sh
x theme feature try transient_enable always
```

Set the theme of the current terminal environment. The transient feature is disabled by default.

```sh
x theme feature try transient_enable never
```

- **Sub Commands**:


| Name | Description |
| ------- | ------- |
| [x theme feature try transient_enable](#x-theme-feature-try-transient-enable) | Enable transient feature |
| [x theme feature try transient_cwd](#x-theme-feature-try-transient-cwd) | Enable transient cwd feature, and there will be prompts in different directories. |
| [x theme feature try transient_time](#x-theme-feature-try-transient-time) | Enable transient cwd feature, and there will the time will be displayed in transient ps1 |
| [x theme feature try symbol](#x-theme-feature-try-symbol) | Select symbol feature |
| [x theme feature try emoji](#x-theme-feature-try-emoji) | Select emoji feature |
| [x theme feature try zshplugin](#x-theme-feature-try-zshplugin) | Load default zsh plugins (zsh-syntax-highlighting、zsh-autosuggestions、zsh-config) |
| [x theme feature try exectime](#x-theme-feature-try-exectime) | Record the execution time of the command, only part of the theme supports this feature |


### x theme feature try transient_enable

Enable transient feature


- **Usage**:

```sh
x theme feature try transient_enable <#1>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | Strategy<br>`always` &#124; `never` &#124; `auto` |


### x theme feature try transient_cwd

Enable transient cwd feature, and there will be prompts in different directories.


- **Usage**:

```sh
x theme feature try transient_cwd <#1>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | Strategy<br>`always` &#124; `never` &#124; `auto` |


### x theme feature try transient_time

Enable transient cwd feature, and there will the time will be displayed in transient ps1


- **Usage**:

```sh
x theme feature try transient_time <#1>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | Strategy<br>`always` &#124; `never` &#124; `auto` |


### x theme feature try symbol

Select symbol feature


- **Sub Commands**:


| Name | Description |
| ------- | ------- |
| [x theme feature try symbol --topic](#x-theme-feature-try-symbol-topic) | Select an existing symbol topic |
| [x theme feature try symbol --custom](#x-theme-feature-try-symbol-custom) | Custom symbol topic |


### x theme feature try symbol --topic

Select an existing symbol topic


- **Usage**:

```sh
x theme feature try symbol --topic|-t <#1>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | topic name<br>`byzantine` &#124; `sumer` &#124; `egypt` &#124; `china` &#124; `dao` ... |


### x theme feature try symbol --custom

Custom symbol topic


- **Usage**:

```sh
x theme feature try symbol --custom|-c <#1>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | symbol string |


### x theme feature try emoji

Select emoji feature


- **Examples**:

Use coffee emoji for the current theme

```sh
x theme feature try emoji ☕
```

Use curl to get weather emoji for the current theme

```sh
x theme feature try emoji "$( curl -s "wttr.in/?format=%c" )"
```

- **Usage**:

```sh
x theme feature try emoji [SUB_COMMAND] <#1>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | Custom emoji<br>`undefined` |


- **Sub Commands**:


| Name | Description |
| ------- | ------- |
| [x theme feature try emoji --topic](#x-theme-feature-try-emoji-topic) | Select an existing emoji topic |


### x theme feature try emoji --topic

Select an existing emoji topic


- **Usage**:

```sh
x theme feature try emoji --topic|-t <#1>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | topic name |


### x theme feature try zshplugin

Load default zsh plugins (zsh-syntax-highlighting、zsh-autosuggestions、zsh-config)


- **Usage**:

```sh
x theme feature try zshplugin <#1>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | Strategy<br>`always` &#124; `never` &#124; `auto` |


### x theme feature try exectime

Record the execution time of the command, only part of the theme supports this feature


- **Usage**:

```sh
x theme feature try exectime <#1>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | Strategy<br>`always` &#124; `never` &#124; `auto` |


### x theme feature reload

Reload the feature configuration of the current environment


- **Usage**:

```sh
x theme feature reload
```

### x theme feature cat

View the global feature config file


- **Usage**:

```sh
x theme feature cat
```

### x theme feature get

Get the value of the specified feature in the current environment


- **Usage**:

```sh
x theme feature get <#1>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | feature<br>`transient_enable` &#124; `transient_cwd` &#124; `transient_time` &#124; `symbol` &#124; `emoji` ... |