docs: unified settings (#2323)

Co-authored-by: John Austin <jaustin@squareup.com>
Co-authored-by: Angie Jones <jones.angie@gmail.com>
Co-authored-by: Rizel Scarlett <rizel@squareup.com>
This commit is contained in:
John Austin
2025-04-23 18:19:19 -07:00
committed by GitHub
parent fd1f829751
commit 85e2ee3984

View File

@@ -240,6 +240,34 @@ Goose works with a set of [supported LLM providers][providers], and youll nee
</TabItem>
</Tabs>
## Goose Configuration Sharing
Goose Desktop and CLI applications share all core configurations, including LLM provider settings, model selection, and extension configurations. When you install or configure extensions in either interface, the settings are stored in a central location at `~/.config/goose/config.yaml`, making them available to both the Desktop application and CLI.
You can manage these shared configurations through the Desktop settings or by using the CLI command `goose configure`, which allows you to add, remove, or toggle extensions and modify other core settings.
## Shared Configuration Settings
The Goose CLI and Desktop UI share all core configurations, including LLM provider settings, model selection, and extension configurations. When you install or configure extensions in either interface, the settings are stored in a central location at `~/.config/goose/config.yaml`, making them available to both the Desktop application and CLI. This makes it convenient to switch between interfaces while maintaining consistent settings.
:::note
While core configurations are shared between interfaces, extensions have flexibility in how they store authentication credentials. Some extensions may use the shared config file while others implement their own storage methods.
:::
<Tabs groupId="interface">
<TabItem value="cli" label="Goose CLI" default>
Use the following command to manage shared configurations:
```sh
goose configure
```
</TabItem>
<TabItem value="ui" label="Goose Desktop">
Navigate to shared configurations through:
1. Click `...` in the upper right corner
2. Click `Advanced Settings`
</TabItem>
</Tabs>
## Additional Resources
You can also configure Extensions to extend Goose's functionality, including adding new ones or toggling them on and off. For detailed instructions, visit the [Using Extensions Guide][using-extensions].