> ## Documentation Index
> Fetch the complete documentation index at: https://developer.watson-orchestrate.ibm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Useful CLI commands

## Checking the ADK version

To check the currently installed version of the ADK, use the `--version` flag.

**Example**

```bash BASH theme={null}
orchestrate --version
```

## Getting help with commands

Use the `--help` flag to get more information about a command and its available flags.

To use it, simply add --help after the command you want to learn more about.

**Example**

<Tabs>
  <Tab title="Example 1">
    ```bash BASH theme={null}
    orchestrate --help
    ```
  </Tab>

  <Tab title="Example 2">
    ```bash BASH theme={null}
    orchestrate env --help
    ```
  </Tab>

  <Tab title="Example 3">
    ```bash BASH theme={null}
    orchestrate agents --help
    ```
  </Tab>

  <Tab title="Example 4">
    ```bash BASH theme={null}
    orchestrate agents import --help
    ```
  </Tab>
</Tabs>

## Running commands in debug mode

If you want more detailed output when running a command, use the `--debug` flag. This runs the command in debug mode and provides additional diagnostic information.

Add --debug before the command you want to run.

**Example**

<Tabs>
  <Tab title="Example 1">
    ```bash BASH theme={null}
    orchestrate --debug env activate local
    ```
  </Tab>

  <Tab title="Example 2">
    ```bash BASH theme={null}
    orchestrate --debug agents import -f agent.yaml
    ```
  </Tab>

  <Tab title="Example 3">
    ```bash BASH theme={null}
    orchestrate --debug tools import -k python -f tool.py
    ```
  </Tab>
</Tabs>

## Settings

ADK opens many files—such as Python, JSON, and YAML—to build agents, tools, knowledge bases, and more. You can override the encoding method ADK uses to decode files when automatic detection fails.

<Note>
  **Note:**

  You don’t need to configure the encoding type to use ADK. The following commands are optional and help handle specific edge cases.
</Note>

### Setting an encoding Type

Set the encoding type ADK uses for file access. If unset, ADK tries to detect the encoding of each file.

To set the encoding type, use the command:

```bash BASH theme={null}
orchestrate settings set-encoding <encoding-type>
```

### Setting encoding to default

Unset the encoding override and return to the default behavior, where ADK tries to detect the encoding of each file.

To set the encoding type to default, use the command:

```bash BASH theme={null}
orchestrate settings unset-encoding
```