---
url: /mod/cd/--relm.md
---
# x cd --relm

relm management


::: tip
The relm name [ws|git|nm|lm] is already taken.

  :ws   points to the current .x-cmd workspace root directory

  :git  points to the current .git directory

  :nm   points to the current .node_modules directory

  :lm   points to the current .lua_modules directory
:::


## Examples

List all defined relm values in the environment

```sh
c -r ls
```

Get the relm directory named git

```sh
c -r get git
```

Define the alias of custom paths and redirect to the corresponding directory

```sh
c -r set t /path/to/directory
c :t

```

## Sub Commands

| Name | Description |
| ------- | ------- |
| [x cd --relm ls](#x-cd-relm-ls) | List predefined and custom relms |
| [x cd --relm set](#x-cd-relm-set) | Set a custom relm directory |
| [x cd --relm get](#x-cd-relm-get) | Get the specified relm directory |
| [x cd --relm rm](#x-cd-relm-rm) | Delete the specified relm directory |
| [x cd --relm cd](#x-cd-relm-cd) | Go to the specified relm directory |


### x cd --relm ls

List predefined and custom relms


- **Usage**:

```sh
x cd --relm|-r ls
```

### x cd --relm set

Set a custom relm directory


- **Usage**:

```sh
x cd --relm|-r set <#1> <#2>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | Relm name |
| `#2` | Directory path |


### x cd --relm get

Get the specified relm directory


- **Usage**:

```sh
x cd --relm|-r get <#1>
```

- **Arguments**:


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


### x cd --relm rm

Delete the specified relm directory


- **Usage**:

```sh
x cd --relm|-r rm <#1>
```

- **Arguments**:


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


### x cd --relm cd

Go to the specified relm directory


- **Usage**:

```sh
x cd --relm|-r cd <#1>
```

- **Arguments**:


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