GithubMirror/continue
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

docs: update configuration and assistant setup documentation

Browse Source
This commit is contained in:
Brian 'bdougie' Douglas
2025-07-31 17:48:56 -07:00
parent 68afb8eb64
commit 8b7b18e615
2 changed files with 49 additions and 50 deletions
Download Patch File Download Diff File Expand all files Collapse all files

48
docs/customize/deep-dives/configuration.mdx
View File

@@ -1,18 +1,43 @@
---
title: "Configuration"
description: Configuration
description: Learn how to access and manage Continue assistant configurations through Hub or local YAML files
keywords: [config, settings, customize]
---
Continue offers two ways to configure your AI assistants: Hub Assistants and Local Assistants (config.yaml).
You can easily access your assistant configuration from the Continue Chat sidebar. Open the sidebar by pressing <kbd>cmd/ctrl</kbd> + <kbd>L</kbd> (VS Code) or <kbd>cmd/ctrl</kbd> + <kbd>J</kbd> (JetBrains) and click the Assistant selector above the main chat input. Then, you can hover over an assistant and click the `new window` (hub assistants) or `gear` (local assistants) icon.
![configure an assistant](/images/configure-continue.png)
## Hub Assistants
Hub Assistants can be managed in [the Hub](https://hub.continue.dev). See [Editing an Assistant](../../hub/assistants/edit-an-assistant.md)
When you [sign in to Continue Hub](https://auth.continue.dev/), you get access to pre-configured assistants that sync automatically across your IDE sessions. To learn more about all the features available in Continue Hub, check out our [hub introduction](/hub/introduction). These assistants are:
## YAML Config
- **Easy to set up** - Add an assistant from [hub.continue.dev](https://hub.continue.dev/explore/assistants) to your account
- **Managed online** - Configure models, add secrets, and customize settings through the web interface
- **Automatically synced** - Changes made on the hub reflect immediately in your IDE
- **Shareable** - Create and share custom assistants with your team
![nextjs assistant](/images/nextjs-assistant.png)
To use Hub assistants:
1. Click the assistant selector above the chat input in your IDE
2. Browse available assistants or create your own
3. Add API keys as [User Secrets](https://hub.continue.dev/settings/secrets) on the hub
4. Click "Reload config" to sync changes
Hub Assistants can be managed in [the Hub](https://hub.continue.dev). See [Editing an Assistant](../../hub/assistants/edit-an-assistant.md) for more details.
## Local Assistants (config.yaml)
For advanced users who prefer local control, Continue supports configuration through a `config.yaml` file. Local assistants offer:
- **Full control** - All configuration stored locally on your machine
- **Version control friendly** - Check your config into git for team consistency
- **Offline usage** - No internet required once models are configured
- **Advanced customization** - Access to all configuration options
Local user-level configuration is stored and can be edited in your home directory in `config.yaml`:
@@ -27,6 +52,23 @@ When editing this file, you can see the available options suggested as you type,
See the full reference for `config.yaml` [here](/reference).
## Which Should You Use?
**Choose Hub assistants if you:**
- Want the quickest setup experience
- Prefer managing configuration through a web interface
- Want access to hosted models-addon
- Need to sync settings across multiple machines
- Want access to pre-configured assistants from the community
**Choose local config.yaml if you:**
- Need version control for your configuration
- Require advanced customization options
- Want complete offline control
- Prefer managing configuration as code
## Deprecated configuration methods
<Info>

51
docs/getting-started/extensions.mdx
View File

@@ -3,52 +3,9 @@ title: "Understanding Assistants"
description: "Continue offers two ways to configure your AI assistants"
---
### Hub Assistants
Continue offers flexible AI assistants that can be configured to match your development workflow. You can choose between:
When you [sign in to Continue Hub](https://auth.continue.dev/), you get access to pre-configured assistants that sync automatically across your IDE sessions. To learn more about all the features available in Continue Hub, check out our [hub introduction](/hub/introduction). These assistants are:
- **Hub Assistants** - Pre-configured assistants that sync across your IDE sessions
- **Local Assistants** - Fully customizable assistants managed through config.yaml
- **Easy to set up** - Add an assistant from [hub.continue.dev](https://hub.continue.dev/explore/assistants) to your account
- **Managed online** - Configure models, add secrets, and customize settings through the web interface
- **Automatically synced** - Changes made on the hub reflect immediately in your IDE
- **Shareable** - Create and share custom assistants with your team
![nextjs assistant](/images/nextjs-assistant.png)
To use Hub assistants:
1. Click the assistant selector above the chat input in your IDE
2. Browse available assistants or create your own
3. Add API keys as [User Secrets](https://hub.continue.dev/settings/secrets) on the hub
4. Click "Reload config" to sync changes
### Local Assistants (config.yaml)
For advanced users who prefer local control, Continue supports configuration through a `config.yaml` file in your `~/.continue` directory. Local assistants offer:
- **Full control** - All configuration stored locally on your machine
- **Version control friendly** - Check your config into git for team consistency
- **Offline usage** - No internet required once models are configured
- **Advanced customization** - Access to all configuration options
To create a local assistant:
1. Create a `config.yaml` file in `~/.continue` (see [config.yaml reference page](/reference))
2. Configure your models, context providers, and other settings
3. Access local assistants through the gear icon in the assistant selector
## Which Should You Use?
**Choose Hub assistants if you:**
- Want the quickest setup experience
- Prefer managing configuration through a web interface
- Want access to hosted models-addon
- Need to sync settings across multiple machines
- Want access to pre-configured assistants from the community
**Choose local config.yaml if you:**
- Need version control for your configuration
- Require advanced customization options
- Want complete offline control
- Prefer managing configuration as code
For detailed information about configuring assistants, including setup instructions and choosing between Hub and Local assistants, see our [configuration deep dive](/customize/deep-dives/configuration).