From 050f7f3af5fc257a6d26555eeed06fe60ae68c24 Mon Sep 17 00:00:00 2001
From: Peli de Halleux <pelikhan@users.noreply.github.com>
Date: Sat, 21 Dec 2024 06:10:57 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20=E2=9C=8F=EF=B8=8F=20update=20CLI=20usa?=
 =?UTF-8?q?ge=20and=20configuration=20sections?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../docs/getting-started/configuration.mdx    |  7 +++++++
 docs/src/content/docs/reference/cli/run.mdx   | 20 ++++++++++++-------
 .../docs/reference/scripts/model-aliases.mdx  |  7 +++++++
 3 files changed, 27 insertions(+), 7 deletions(-)

diff --git a/docs/src/content/docs/getting-started/configuration.mdx b/docs/src/content/docs/getting-started/configuration.mdx
index 00ec0dc96..5c6155956 100644
--- a/docs/src/content/docs/getting-started/configuration.mdx
+++ b/docs/src/content/docs/getting-started/configuration.mdx
@@ -64,6 +64,13 @@ GENAISCRIPT_MODEL_SMALL="azure_serverless:..."
 GENAISCRIPT_MODEL_VISION="azure_serverless:..."
 ```
 
+You can also configure the default aliases for a given LLM provider by using the `--provider` argument in the CLI.
+The default are documented in this page and printed to the console output.
+
+```sh
+genaiscript run ... --provider anthropic
+```
+
 ### Model aliases
 
 In fact, you can define any alias for your model (only alphanumeric characters are allowed)
diff --git a/docs/src/content/docs/reference/cli/run.mdx b/docs/src/content/docs/reference/cli/run.mdx
index 4ff50a19a..b0d0efa94 100644
--- a/docs/src/content/docs/reference/cli/run.mdx
+++ b/docs/src/content/docs/reference/cli/run.mdx
@@ -50,11 +50,21 @@ Exclude files ignored by the `.gitignore` file at the workspace root.
 npx genaiscript run <script> <files> --exclude-git-ignore
 ```
 
-## Output
+## Configuration
+
+### --model ...
+
+Configure the default or `large` model alias
+
+## --provider ...
 
-### --prompt
+Loads a set of model aliases for the given LLM provider.
 
-Skips the LLM invocation and only prints the expanded system and user chat messages.
+### --vars name=value name2=value2 ...
+
+Populate values in the `env.vars` map that can be used when running the prompt.
+
+## Output
 
 ### --out &lt;file|directory&gt;
 
@@ -78,10 +88,6 @@ Output the entire response as JSON to the stdout.
 
 Output the entire response as YAML to the stdout.
 
-### --vars name=value name2=value2 ...
-
-Populate values in the `env.vars` map that can be used when running the prompt.
-
 ### --out-trace &lt;file&gt;
 
 Save the markdown trace to the specified file.
diff --git a/docs/src/content/docs/reference/scripts/model-aliases.mdx b/docs/src/content/docs/reference/scripts/model-aliases.mdx
index 41b1bdfe0..161f1193f 100644
--- a/docs/src/content/docs/reference/scripts/model-aliases.mdx
+++ b/docs/src/content/docs/reference/scripts/model-aliases.mdx
@@ -89,3 +89,10 @@ The following aliases are also set so that you can override LLMs used by GenAISc
 
 - `agent`: `large`. Model used by the Agent LLM.
 - `memory`: `small`. Moel used by the agent short term memory.
+
+The default aliases for a given provider can be loaded using the `provider` option in the [cli](/genaiscript/reference/cli/run).
+
+```sh
+genaiscript run --provider anthropic
+```
+