# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.filestar.com/automation/filestar-cli.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.