# dotfiles

Personalize your workspace by applying a canonical dotfiles repository

## Usage [#usage]

```console
coder dotfiles [flags] <git_repo_url>
```

## Description [#description]

```console
  - Check out and install a dotfiles repository without prompts:

     $ coder dotfiles --yes git@github.com:example/dotfiles.git
```

## Options [#options]

### --symlink-dir [#--symlink-dir]

|             |                                   |
| ----------- | --------------------------------- |
| Type        | <code>string</code>               |
| Environment | <code>$CODER\_SYMLINK\_DIR</code> |

Specifies the directory for the dotfiles symlink destinations. If empty, will use $HOME.

### -b, --branch [#-b---branch]

|      |                     |
| ---- | ------------------- |
| Type | <code>string</code> |

Specifies which branch to clone. If empty, will default to cloning the default branch or using the existing branch in the cloned repo on disk.

### --repo-dir [#--repo-dir]

|             |                                          |
| ----------- | ---------------------------------------- |
| Type        | <code>string</code>                      |
| Environment | <code>$CODER\_DOTFILES\_REPO\_DIR</code> |
| Default     | <code>dotfiles</code>                    |

Specifies the directory for the dotfiles repository, relative to global config directory.

### -y, --yes [#-y---yes]

|      |                   |
| ---- | ----------------- |
| Type | <code>bool</code> |

Bypass confirmation prompts.