---
myst:
  html_meta:
    "description lang=en":
      "Command line reference for Ubuntu Pro for WSL's Windows agent."
---

# Windows Agent CLI

```{include} ../dev_docs_notice.txt
    :start-after: <!-- Include start dev -->
    :end-before: <!-- Include end dev -->
```

> See first: [UP4W - Windows Agent](ref::up4w-windows-agent)


## Usage

### User commands

#### ubuntu-pro-agent

Ubuntu Pro for WSL agent

##### Synopsis

Ubuntu Pro for WSL agent for managing your pro-enabled distro.

```
ubuntu-pro-agent COMMAND [flags]
```

##### Options

```
  -c, --config string     configuration file path
  -h, --help              help for ubuntu-pro-agent
  -v, --verbosity count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output
```

#### ubuntu-pro-agent clean

Removes all the agent's data and exits

```
ubuntu-pro-agent clean [flags]
```

##### Options

```
  -h, --help   help for clean
```

##### Options inherited from parent commands

```
  -c, --config string     configuration file path
  -v, --verbosity count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output
```

#### ubuntu-pro-agent completion

Generate the autocompletion script for the specified shell

##### Synopsis

Generate the autocompletion script for ubuntu-pro-agent for the specified shell.
See each sub-command's help for details on how to use the generated script.


##### Options

```
  -h, --help   help for completion
```

##### Options inherited from parent commands

```
  -c, --config string     configuration file path
  -v, --verbosity count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output
```

#### ubuntu-pro-agent completion bash

Generate the autocompletion script for bash

##### Synopsis

Generate the autocompletion script for the bash shell.

This script depends on the 'bash-completion' package.
If it is not installed already, you can install it via your OS's package manager.

To load completions in your current shell session:

	source <(ubuntu-pro-agent completion bash)

To load completions for every new session, execute once:

###### Linux:

	ubuntu-pro-agent completion bash > /etc/bash_completion.d/ubuntu-pro-agent

###### macOS:

	ubuntu-pro-agent completion bash > $(brew --prefix)/etc/bash_completion.d/ubuntu-pro-agent

You will need to start a new shell for this setup to take effect.


```
ubuntu-pro-agent completion bash
```

##### Options

```
  -h, --help              help for bash
      --no-descriptions   disable completion descriptions
```

##### Options inherited from parent commands

```
  -c, --config string     configuration file path
  -v, --verbosity count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output
```

#### ubuntu-pro-agent completion fish

Generate the autocompletion script for fish

##### Synopsis

Generate the autocompletion script for the fish shell.

To load completions in your current shell session:

	ubuntu-pro-agent completion fish | source

To load completions for every new session, execute once:

	ubuntu-pro-agent completion fish > ~/.config/fish/completions/ubuntu-pro-agent.fish

You will need to start a new shell for this setup to take effect.


```
ubuntu-pro-agent completion fish [flags]
```

##### Options

```
  -h, --help              help for fish
      --no-descriptions   disable completion descriptions
```

##### Options inherited from parent commands

```
  -c, --config string     configuration file path
  -v, --verbosity count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output
```

#### ubuntu-pro-agent completion powershell

Generate the autocompletion script for powershell

##### Synopsis

Generate the autocompletion script for powershell.

To load completions in your current shell session:

	ubuntu-pro-agent completion powershell | Out-String | Invoke-Expression

To load completions for every new session, add the output of the above command
to your powershell profile.


```
ubuntu-pro-agent completion powershell [flags]
```

##### Options

```
  -h, --help              help for powershell
      --no-descriptions   disable completion descriptions
```

##### Options inherited from parent commands

```
  -c, --config string     configuration file path
  -v, --verbosity count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output
```

#### ubuntu-pro-agent completion zsh

Generate the autocompletion script for zsh

##### Synopsis

Generate the autocompletion script for the zsh shell.

If shell completion is not already enabled in your environment you will need
to enable it.  You can execute the following once:

	echo "autoload -U compinit; compinit" >> ~/.zshrc

To load completions in your current shell session:

	source <(ubuntu-pro-agent completion zsh)

To load completions for every new session, execute once:

###### Linux:

	ubuntu-pro-agent completion zsh > "${fpath[1]}/_ubuntu-pro-agent"

###### macOS:

	ubuntu-pro-agent completion zsh > $(brew --prefix)/share/zsh/site-functions/_ubuntu-pro-agent

You will need to start a new shell for this setup to take effect.


```
ubuntu-pro-agent completion zsh [flags]
```

##### Options

```
  -h, --help              help for zsh
      --no-descriptions   disable completion descriptions
```

##### Options inherited from parent commands

```
  -c, --config string     configuration file path
  -v, --verbosity count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output
```

#### ubuntu-pro-agent version

Returns version of agent and exits

```
ubuntu-pro-agent version [flags]
```

##### Options

```
  -h, --help   help for version
```

##### Options inherited from parent commands

```
  -c, --config string     configuration file path
  -v, --verbosity count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output
```

### Hidden commands

Those commands are hidden from help and should primarily be used by the system or for debugging.