diff --git a/docs/clearml_agent/clearml_agent_ref.md b/docs/clearml_agent/clearml_agent_ref.md
index 61d4b919..f5022402 100644
--- a/docs/clearml_agent/clearml_agent_ref.md
+++ b/docs/clearml_agent/clearml_agent_ref.md
@@ -12,7 +12,12 @@ The following page provides a reference to `clearml-agent`'s CLI commands:
## build
-Create a worker environment without executing the experiment.
+Use the `build` command to create worker environments without executing tasks.
+
+You can build Docker containers according to the execution environments of specific tasks, which an agent can later
+use to execute other tasks. See tutorial [here](../guides/clearml_agent/exp_environment_containers.md).
+
+You can also create a Docker container that executes a specific task when launched. See tutorial [here](../guides/clearml_agent/executable_exp_containers.md).
```bash
clearml-agent build [-h] --id TASK_ID [--target TARGET]
@@ -31,7 +36,7 @@ clearml-agent build [-h] --id TASK_ID [--target TARGET]
|---|----|---|
|`--id`| Build a worker environment for this Task ID.|
|
|`--cpu-only`| Disable GPU access for the Docker container.|
|
-|`--docker`| Run agent in Docker mode. Specify Docker container that a worker will execute at launch. To specify the image name and optional arguments, use one of the following:
- `--docker ` on the command line
- `--docker` on the command line, and specify the default image name and arguments in the configuration file.
Environment variable settings for Docker containers: - `CLEARML_DOCKER_SKIP_GPUS_FLAG` - Ignore the `--gpus` flag inside the Docker container. This also allows you to execute ClearML Agent using Docker versions earlier than 19.03.
- `NVIDIA_VISIBLE_DEVICES` - Limit GPU visibility for the Docker container.
- `CLEARML_AGENT_GIT_USER` and `CLEARML_AGENT_GIT_PASS` - Pass these credentials to the Docker container at execution.
To limit GPU visibility for Docker, set the `NVIDIA_VISIBLE_DEVICES` environment variable.|
|
+|`--docker`| Run agent in Docker mode. Specify a Docker container that a worker will execute at launch. To specify the image name and optional arguments, use one of the following: - `--docker ` on the command line
- `--docker` on the command line, and specify the default image name and arguments in the configuration file.
Environment variable settings for Docker containers: - `CLEARML_DOCKER_SKIP_GPUS_FLAG` - Ignore the `--gpus` flag inside the Docker container. This also allows you to execute ClearML Agent using Docker versions earlier than 19.03.
- `NVIDIA_VISIBLE_DEVICES` - Limit GPU visibility for the Docker container.
- `CLEARML_AGENT_GIT_USER` and `CLEARML_AGENT_GIT_PASS` - Pass these credentials to the Docker container at execution.
To limit GPU visibility for Docker, set the `NVIDIA_VISIBLE_DEVICES` environment variable.|
|
|`--entry-point`| Used in conjunction with `--docker`, indicates how to run the Task specified by `--task-id` on Docker startup. The `--entry-point` options are: - `reuse` - Overwrite the existing Task data.
- `clone_task` - Clone the Task, and execute the cloned Task.
|
|
|`--force-docker`| Force using the agent-specified docker image (either explicitly in the `--docker` argument or using the agent's default docker image). If provided, the agent will not use any docker container information stored in the task itself (default `False`)|
|
|`--git-pass`| Git password for repository access.|
|
@@ -53,7 +58,11 @@ clearml-agent config [-h]
## daemon
-Run a worker, optionally in a Docker container, listening to a queue.
+Use the `daemon` command to spin up an agent on any machine: on-prem and/or cloud instance. When spinning up an agent,
+assign it a queue(s) to service, and when experiments are added to its queues, the agent will pull and execute them.
+
+With the `daemon` command you can configure your agent's behavior: allocate resources, prioritize queues, set it to run
+in a Docker, and more.
```bash
clearml-agent daemon [-h] [--foreground] [--queue QUEUES [QUEUES ...]] [--order-fairness]
@@ -99,7 +108,8 @@ clearml-agent daemon [-h] [--foreground] [--queue QUEUES [QUEUES ...]] [--order-
## execute
-Build and execute an experiment without a queue.
+Use the `execute` command to set an agent to build and execute specific tasks directly without listening to a queue.
+
```bash
clearml-agent execute [-h] --id TASK_ID [--log-file LOG_FILE] [--disable-monitoring]