Merge master into v3 branch

Resolve merge conflicts to enable CI checks.

Squashed commit of the following:

commit 36d65cf
Author: Nikolay V. Krasko <[email protected]>
Date:   Fri Sep 5 15:52:41 2025 +0400

    adding notes with status

commit 2277748
Author: Nikolay V. Krasko <[email protected]>
Date:   Fri Sep 5 15:43:37 2025 +0400

    addding enapter3 cli usage description

Author: danya

README.md

@@ -4,14 +4,26 @@
 [![Release](https://img.shields.io/github/release/enapter/enapter-cli.svg)](https://github.com/enapter/enapter-cli/releases/latest)
 
 
-This tool helps Enapter customers to work with devices. It useful in the following cases:
-1. Develop devices via blueprints.
-2. Update and monitor devices.
+This tool helps Enapter customers to work with devices it is alternative for [Enapter IDE for EMS Toolkit 3.0](https://marketplace.visualstudio.com/items?itemName=Enapter.enapter-ems-toolkit-ide).
+It helpful in the following cases:
+
+1. Managing all your EMS setup as a code with Git and Ansible / Puppet
+2. Establishing CI/CD workflow
+3. Development and debugging of Enapter Blueprints
+4. Development and debugging of Enapter Gateway Rules
 
 ## How to install
 
 ###  macOS - recommended
 
+Version 1:
+
+```bash
+brew tap enapter/tap && brew install enapter
+```
+
+Version 3:
+
 ```bash
 brew tap enapter/tap && brew install enapter@3
 ```
@@ -32,7 +44,10 @@ Also you can pass custom output path:
 ./build.sh /usr/local/bin/enapter
 ```
 
-## How to use
+## How to use Version 1:
+
+> [!NOTE]
+> Version 1 works only with Enapter Cloud connection.
 
 ### API token
 
@@ -52,8 +67,35 @@ Enapter CLI requires access token for authentication. Obtaining of the token is
 
 Please note that if you don't save your token, it is not possible to reveal it anymore. You need generate new token.
 
+## How to use Version 3:
+
+### API token
+
+Enapter CLI requires access token for authentication. Obtaining of the token is easy and can be done by following few steps.
+
+1. Navigate to your Enapter Gateway 3.0 Web Interface `Settings` page by using IP address or mDNS name [http://enapter-gateway.local/settings](https://enapter-gateway.local/settings)
+2. Enapter your Enapter Gateway password
+3. Click `API Token` and copy token to clipboard
+4. Set environment variables `ENAPTER3_API_TOKEN`, `ENAPTER3_API_URL` and `ENAPTER3_API_ALLOW_INSECURE`. To make it permanent don't forget to add it to configuration files of your shell.
+
+  ```bash
+  export ENAPTER3_API_TOKEN="your token"
+  export ENAPTER3_API_URL="http://ip_address/api"
+  export ENAPTER3_API_ALLOW_INSECURE=true
+  ```
+
+5. Check connection works by running
+
+  ```bash
+  enapter3 device list
+  ```
+
 ### Autocompletion in your favourite terminal app
 
-In order to make life easier with command line interface, you may use [Fig - the next-generation command line](https://fig.io/). This autocompletion tool has native support for the Enapter CLI for Mac OS X and Linux.
+> [!NOTE]
+> Available for Version 1 now.
+
+In order to make life easier with command line interface, you may use [Amazon Q](https://aws.amazon.com/q/). This autocompletion tool has native support for the Enapter CLI for Mac OS X and Linux.
 
 <img src="./.assets/enapter-cli-fig-integration.gif">
+