# CLI configuration

The Telosys-CLI configuration is defined in the file **`telosys-cli.cfg`**.   

This file is located in the directory where Telosys-CLI has been installed.  It can be edited with any text editor.

For now, this file simply allows you to define a **specific external editor** that will be launched for all "edit" commands (eg "eb", "ecfg", etc.) and a **specific file explorer** for "fx" command.

## Text editor configuration

Telosys-CLI comes with its own text editor, but this editor is quite basic and requires a graphical interface (eg GNOME or KDE for Linux). So you might prefer to set another text editor.

Telosys allows you to define a command to launch your favorite text editor for example     \
 "Visual Source Code", "Atom", "Sublime Text", "Notepad++", etc

Use the **`EditorCommand`** property to define the command that will be launched by Telosys-CLI.

The value is the OS command to execute to launch the editor. If the executable file is accessible via the "PATH", you can use it as a simple command (without full path). Otherwise, you need to find where the editor is installed and use the full path.

The **`$FILE`** variable is a placeholder representing the file to edit.

### EditorCommand examples

**Visual Studio Code** ( executable file is "code" )

```
EditorCommand = code $FILE
EditorCommand = D:/Tools/Microsoft VS Code/code.exe $FILE 
```

**Atom editor** ( executable file is "atom" )

```
EditorCommand = atom $FILE
EditorCommand = D:/Tools/atom/atom.exe $FILE
```

**Sublime Text** ( executable file is "subl" )

```
EditorCommand = subl $FILE
EditorCommand = D:/Tools/SublimeText/subl.exe $FILE
```

**Notepad++** ( executable file is "notepad++" )

```
EditorCommand = notepad++ $FILE
EditorCommand = C:/Program Files (x86)/Notepad++/notepad++.exe $FILE
```

**Linux Mint editors**

```
EditorCommand = /usr/bin/xed $FILE
EditorCommand = /usr/bin/gnome-terminal -e "vi $FILE"
EditorCommand = /usr/bin/gnome-terminal -e "nano $FILE"
```

**Linux Lubuntu editors**

```
EditorCommand = /usr/bin/leafpad $FILE & 
EditorCommand = /usr/bin/lxterminal -e "vi $FILE"
EditorCommand = /usr/bin/lxterminal -e "nano $FILE"
```

## File explorer configuration 

The "**fx**" command launches a file explorer in the current directory (since ver 4.1.0). 

2 commands are defined by default : "explorer" for Windows and "open" for MacOS.

You can set your own command to use your favorite explorer   \
by using the  **`FileExplorerCommand`**   property

The variable **`$DIR`** is a placeholder for the directory where to start the explorer.

### FileExplorerCommand examples 

**Windows - 'TotalCommander'**  

```
FileExplorerCommand = C:/Program Files/totalcmd/totalcmd64.exe $DIR
```

**Linux Ubuntu - 'Nautilus'** ( executable file is "nautilus" )

```
FileExplorerCommand = nautilus $DIR
```


---

# 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://doc.telosys.org/telosys-cli/cli-configuration.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.