diff --git a/.gitignore b/.gitignore
index 59c012eb57..b7020f70f5 100644
--- a/.gitignore
+++ b/.gitignore
@@ -24,3 +24,5 @@ dev/
foobar*.genai.mjs
azure-sdk-for-js/
trapi.md
+.env.local
+genaiscript.config.yaml
diff --git a/.vscode/settings.json b/.vscode/settings.json
index 658a7ff864..57ecd38b4d 100644
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -100,25 +100,6 @@
},
"files.eol": "\n",
"terminal.integrated.defaultProfile.windows": "Git Bash",
- "workbench.colorCustomizations": {
- "activityBar.activeBackground": "#443c00",
- "activityBar.background": "#443c00",
- "activityBar.foreground": "#e7e7e7",
- "activityBar.inactiveForeground": "#e7e7e799",
- "activityBarBadge.background": "#008071",
- "activityBarBadge.foreground": "#e7e7e7",
- "commandCenter.border": "#e7e7e799",
- "sash.hoverBorder": "#443c00",
- "statusBar.background": "#110f00",
- "statusBar.foreground": "#e7e7e7",
- "statusBarItem.hoverBackground": "#443c00",
- "statusBarItem.remoteBackground": "#110f00",
- "statusBarItem.remoteForeground": "#e7e7e7",
- "titleBar.activeBackground": "#110f00",
- "titleBar.activeForeground": "#e7e7e7",
- "titleBar.inactiveBackground": "#110f0099",
- "titleBar.inactiveForeground": "#e7e7e799"
- },
"peacock.remoteColor": "#110f00",
"mdmath.delimiters": "brackets",
"spellright.language": [
diff --git a/THIRD_PARTY_LICENSES.md b/THIRD_PARTY_LICENSES.md
index 532bf3d4a9..66637f41ac 100644
--- a/THIRD_PARTY_LICENSES.md
+++ b/THIRD_PARTY_LICENSES.md
@@ -1464,7 +1464,7 @@ available under the Apache 2.0 license (https://github.com/puppeteer/puppeteer/b
The following npm package may be included in this product:
- - mathjs@13.2.1
+ - mathjs@13.2.2
This package contains the following license:
@@ -1702,7 +1702,7 @@ MIT License
The following npm package may be included in this product:
- - genaiscript-vscode@1.74.0
+ - genaiscript-vscode@1.74.1
This package contains the following license:
@@ -3820,16 +3820,6 @@ IN THE SOFTWARE.
-----------
-The following npm package may be included in this product:
-
- - buildcheck@0.0.6
-
-This package contains the following license:
-
-http://github.com/mscdex/buildcheck/raw/master/LICENSE
-
------------
-
The following npm package may be included in this product:
- ssh2@1.16.0
@@ -3840,16 +3830,6 @@ http://github.com/mscdex/ssh2/raw/master/LICENSE
-----------
-The following npm package may be included in this product:
-
- - cpu-features@0.0.10
-
-This package contains the following license:
-
-https://github.com/mscdex/cpu-features/raw/master/LICENSE
-
------------
-
The following npm packages may be included in this product:
- boolbase@1.0.0
@@ -4582,12 +4562,12 @@ THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
The following npm packages may be included in this product:
- - @esbuild/linux-x64@0.23.1
+ - @esbuild/win32-x64@0.23.1
- @tokenizer/token@0.3.0
- canvas@3.0.0-rc2
- - genaiscript-core-internal@1.74.0
- - genaiscript-sample@1.74.0
- - genaiscript@1.74.0
+ - genaiscript-core-internal@1.74.1
+ - genaiscript-sample@1.74.1
+ - genaiscript@1.74.1
- isarray@1.0.0
- javascript-natural-sort@0.7.1
- keyv@4.5.4
@@ -5356,7 +5336,7 @@ SOFTWARE.
The following npm package may be included in this product:
- - gpt-tokenizer@2.6.1
+ - gpt-tokenizer@2.6.2
This package contains the following license:
@@ -5514,7 +5494,7 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
The following npm packages may be included in this product:
- undici-types@6.19.8
- - undici@6.20.1
+ - undici@6.21.0
These packages each contain the following license:
diff --git a/docs/src/content/docs/getting-started/configuration.mdx b/docs/src/content/docs/getting-started/configuration.mdx
index b48053ee5a..97407014e8 100644
--- a/docs/src/content/docs/getting-started/configuration.mdx
+++ b/docs/src/content/docs/getting-started/configuration.mdx
@@ -20,6 +20,7 @@ import lmSelectAlt from "../../../assets/vscode-language-models-select.png.txt?r
import oaiModelsSrc from "../../../assets/openai-model-names.png"
import oaiModelsAlt from "../../../assets/openai-model-names.png.txt?raw"
+
You will need to configure the LLM connection and authorization secrets.
:::tip
@@ -134,6 +135,12 @@ npx genaiscript ... --env .env.local
GENAISCRIPT_ENV_FILE=.env.local npx genaiscript ...
```
+- by specifying the `.env` file location in a [configuration file](/genaiscript/reference/configuration-files).
+
+```yaml file="~/genaiscript.config.yaml"
+envFile: ~/.env.genaiscript
+```
+
## OpenAI
This provider, `openai`, is the OpenAI chat model provider.
diff --git a/docs/src/content/docs/reference/configuration-files.mdx b/docs/src/content/docs/reference/configuration-files.mdx
new file mode 100644
index 0000000000..81c8014a87
--- /dev/null
+++ b/docs/src/content/docs/reference/configuration-files.mdx
@@ -0,0 +1,29 @@
+---
+title: Configuration Files
+description: Learn how to configure common configuration settings using configuration files
+sidebar:
+ order: 90
+---
+
+import { Code } from "@astrojs/starlight/components"
+import hostConfigurationSource from "../../../../../packages/core/src/hostconfiguration.ts?raw"
+
+GenAIScript supports local and global configuration files to allow reusing common configuration settings and secrets across multiple scripts.
+
+## File resolution
+
+GenAIScript will scan for the following configuration files
+and merge their content into the final configuration.
+
+- `~/genaiscript.config.yaml`
+- `~/genaiscript.config.json`
+- `./genaiscript.config.yaml`
+- `./genaiscript.config.json`
+
+## File format
+
+The configuration file format is the following:
+
+