> For the complete documentation index, see [llms.txt](https://help.filestar.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.filestar.com/automation/filestar-cli.md).

# Filestar CLI

{% hint style="info" %}
Filestar CLI is currently only available on Windows.
{% endhint %}

<figure><img src="/files/lILBujRHdBtm7IkEOEYk" alt=""><figcaption></figcaption></figure>

### Examples

Convert cat.jpg in the current folder to cat.png and store it in the folder c:\workspace:

```
>filestarcli -i cat.jpg -c "convert to png" -o C:\workspace
```

Merge page1.pdf and page2.pdf in the current folder:

```
>filestarcli -i page1.pdf page2.pdf -c "merge"
```

### Arguments <a href="#arguments" id="arguments"></a>

```
-i <input>
--input <input>
```

Specify paths as absolute or relative to current directories. It can contain a combination of valid literal path and wildcard (\* and ?) characters, but it doesn't support regular expressions.

```
-o <output>
--output <output>
-o . 
-o foo.gif
-o "c:\foo bar\"
-o c:\foo\bar.<Extension>
```

Specifies how to handle the output. If omitted each file will be saved in its respective source directory.

```
-r
--recursive
```

Recursively find files in sub-directories in the current directory.

```
-c
--command
```

Command, i.e. "convert to jpg"

```
-p
--parameters
```

Skill parameters.

```
--output-template <output-template>
```

Specifies how to name the converted files. If omitted, this template is used: \<Filename>.\<Extension>

```
--loglevel
```

Available options:

* Normal (default)
* Quiet
* Verbose

```
--recipe
```

Path to a stored recipe file.

```
--cloud
```

Specify how to handle cloud skills.

Available options:

* Disallowed (default)
* Allowed
* Forced

```
--output-conflict
```

Strategy to use if there are conflicting filenames when saving files.

Available options:

* AppendNumber (default)
* Replace
* Skip
* Warn

```
--version
```

Show version information

```
 -?, -h, --help
```

Show help and usage information.

### Commands <a href="#commands" id="commands"></a>

```
>filestarcli register <Activation Code>
```

Register Filestar on the current machine with the specified activation code.

```
>filestarcli update
```

Update Filestar on the current machine to the latest version.