Compare commits

..

6 Commits

Author SHA1 Message Date
Tony Loehr 4c266718da fix syntax error 2026-04-08 16:30:17 -07:00
John Choi 9390d3f933 fix: update KanbanMigrationView test to match component text (#10173)
#10161 updated the component copy but missed updating the test assertions.
This breaks CI on main and any branch based on it.
2026-04-07 16:27:38 -07:00
Saoud Rizwan 5df470bf48 fix(cli): update kanban migration view copy to not imply TUI deprecation (#10161)
The previous copy ("Cline is moving out of the terminal", "old CLI")
gave the impression that the terminal TUI was being deprecated. Updated
to frame Kanban as the new default while making clear the TUI is still
fully available.
2026-04-06 16:00:11 -07:00
Tony Loehr 034c4342d1 Complete documentation for environment variable-based OpenTelemetry configs (#10155)
* Complete documentation for environment variable-based OpenTelemetry configuration

* Address PR review comments

- Add Values column to OTLP Configuration table for consistency
- Fix New Relic endpoint to include required port 4318
- Add note about Datadog region-specific endpoints
2026-04-06 17:22:57 -04:00
Tony Loehr 349295ab2c docs: remove Teams Plan references, focus on Enterprise (#10153)
Remove Teams Plan as an option for seat upgrades in the managing-members documentation. This aligns with the product strategy to drive customers toward Enterprise for any multiplayer/team scenarios.

Related: https://github.com/cline/cline-web/pull/256
2026-04-06 11:28:50 -07:00
Tony Loehr 841402c178 docs: add all enterprise inference providers to Remote Provider Configuration (#10127)
* docs: add OpenAI Compatible and Anthropic to enterprise SaaS provider configuration

Add documentation for all inference providers supported by the core
platform's remote config system (ProviderSettingsSchema). Previously
only Bedrock, Vertex, and LiteLLM had dedicated pages.

New pages:
- OpenAI Compatible admin/member config (covers Azure Foundry)
- Anthropic admin/member config

Updated:
- overview.mdx: expanded provider table to 7 rows
- docs.json: added navigation groups
- Capabilities Manual: added provider links

* Update docs/enterprise-solutions/configuration/remote-configuration/overview.mdx

Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>

* Update docs/enterprise-solutions/configuration/remote-configuration/overview.mdx

Co-authored-by: Renee Huang <100229782+reneehuang1@users.noreply.github.com>

---------

Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>
Co-authored-by: Renee Huang <100229782+reneehuang1@users.noreply.github.com>
2026-04-06 03:51:43 +00:00
12 changed files with 657 additions and 119 deletions
@@ -8,11 +8,11 @@ describe("KanbanMigrationView", () => {
const onSelect = vi.fn()
const { lastFrame } = render(createElement(KanbanMigrationView, { isRawModeSupported: true, onSelect }))
expect(lastFrame()).toContain("Cline is moving out of the terminal. Introducing Cline Kanban.")
expect(lastFrame()).toContain("Introducing Cline Kanban!")
expect(lastFrame()).toContain("Open the new experience")
expect(lastFrame()).toContain("Launch Cline Kanban and start there by default.")
expect(lastFrame()).toContain("cline --tui")
expect(lastFrame()).toContain("Close and rerun with cline --tui if you want the old CLI.")
expect(lastFrame()).toContain("You can always run cline --tui for the terminal experience.")
expect(lastFrame()).toContain("Exit")
})
+2 -2
View File
@@ -30,7 +30,7 @@ const InternalKanbanMigrationView: React.FC<Pick<KanbanMigrationViewProps, "onSe
},
{
label: "Exit",
description: "Close and rerun with cline --tui if you want the old CLI.",
description: "You can always run cline --tui for the terminal experience.",
value: "exit",
},
],
@@ -60,7 +60,7 @@ const InternalKanbanMigrationView: React.FC<Pick<KanbanMigrationViewProps, "onSe
<StaticRobotFrame />
<Text> </Text>
<Text bold color="white">
Cline is moving out of the terminal. Introducing Cline Kanban.
Introducing Cline Kanban!
</Text>
<Text color="gray">A board for orchestrating coding agents across worktrees, right from your browser.</Text>
<Text> </Text>
+1 -1
View File
@@ -60,7 +60,7 @@ This command is only available in VS Code.
`/explain-changes` generates AI-powered explanations for any git diff. You can explain the last commit, uncommitted work, staged changes, specific commits, branches, PRs, or any range of changes.
Use `/explain-changes` when reviewing code, onboarding to a new codebase, or understanding what changed. For the full list of use cases and examples, see [Explain Changes](/features/explain-changes).
Use `/explain-changes` when reviewing code, onboarding to a new codebase, or understanding what changed. For the full list of use cases and examples, see [Explain Changes Command](#explain-changes).
### /reportbug
+23 -10
View File
@@ -132,7 +132,6 @@
"features/background-edit",
"features/jupyter-notebooks",
"features/deep-planning",
"features/explain-changes",
"features/web-tools",
"features/worktrees"
]
@@ -259,7 +258,7 @@
"enterprise-solutions/sso-setup",
"enterprise-solutions/team-management/managing-members",
{
"group": "SaaS Provider Configuration",
"group": "Remote Provider Configuration",
"pages": [
"enterprise-solutions/configuration/remote-configuration/overview",
{
@@ -269,19 +268,33 @@
"enterprise-solutions/configuration/remote-configuration/aws-bedrock/member-configuration"
]
},
{
"group": "LiteLLM",
"pages": [
"enterprise-solutions/configuration/remote-configuration/litellm/admin-configuration",
"enterprise-solutions/configuration/remote-configuration/litellm/member-configuration"
]
},
{
"group": "Google Vertex AI",
"pages": [
"enterprise-solutions/configuration/remote-configuration/google-vertex/admin-configuration",
"enterprise-solutions/configuration/remote-configuration/google-vertex/member-configuration"
]
},
{
"group": "OpenAI Compatible",
"pages": [
"enterprise-solutions/configuration/remote-configuration/openai-compatible/admin-configuration",
"enterprise-solutions/configuration/remote-configuration/openai-compatible/member-configuration"
]
},
{
"group": "Anthropic",
"pages": [
"enterprise-solutions/configuration/remote-configuration/anthropic/admin-configuration",
"enterprise-solutions/configuration/remote-configuration/anthropic/member-configuration"
]
},
{
"group": "LiteLLM",
"pages": [
"enterprise-solutions/configuration/remote-configuration/litellm/admin-configuration",
"enterprise-solutions/configuration/remote-configuration/litellm/member-configuration"
]
}
]
},
@@ -644,7 +657,7 @@
},
{
"source": "/features/slash-commands/explain-changes",
"destination": "/features/explain-changes"
"destination": "/core-workflows/using-commands#explain-changes"
},
{
"source": "/features/slash-commands/new-rule",
@@ -0,0 +1,98 @@
---
title: "Configure Anthropic Provider (Admin)"
sidebarTitle: "Configure Anthropic (Admin)"
description: "This guide explains how administrators configure Anthropic as the organization-wide LLM provider for Cline."
---
As an administrator, you can add Anthropic as the organization-wide LLM provider for all Cline users through the hosted admin console. This centralized approach provides direct access to Anthropic's Claude models, with an optional custom base URL for organizations that route traffic through a proxy.
## Before You Begin
To get started with setting up Anthropic as your organization's LLM provider, you'll need a few items in place.
**Administrator access to the Cline Admin console**
You need admin privileges to enforce provider settings across your organization. If you can navigate to **Settings → Cline Settings** in the admin console at [app.cline.bot](https://app.cline.bot), you have the right access level.
**Anthropic API access**
Your organization needs an Anthropic account with API access to Claude models. Members will need individual API keys to authenticate.
<Note>
If your organization requires routing API traffic through a proxy or custom endpoint, have the proxy URL ready before configuring.
</Note>
## Configuration Steps
<Steps>
<Step title="Access Cline Settings">
Navigate to [app.cline.bot](https://app.cline.bot) and sign in with your administrator account. Go to **Settings → Cline Settings**.
<Info>
You should see the provider configuration options if you have the correct admin access level.
</Info>
</Step>
<Step title="Enable Remote Provider Configuration">
Toggle on **Enable settings** to reveal the remote provider configuration options. This allows you to enforce provider settings across your organization.
</Step>
<Step title="Select Anthropic as the API Provider">
Open the **API Provider** dropdown menu and select **Anthropic**. This will open the Anthropic configuration panel where you'll configure all your organization-wide settings.
</Step>
<Step title="Configure Anthropic Settings">
The configuration panel includes settings that control how Anthropic works for your organization:
<AccordionGroup>
<Accordion title="Base URL (optional)">
By default, Cline connects directly to the Anthropic API (`https://api.anthropic.com`). If your organization routes API traffic through a proxy or custom endpoint, enter the base URL here.
Use cases for a custom base URL:
- Corporate proxy that logs or filters API traffic
- Self-hosted API gateway for rate limiting or access control
- Regional routing requirements
Leave this empty to use the default Anthropic API endpoint.
<Tip>
If using a proxy, ensure it correctly forwards requests to the Anthropic API and preserves all required headers.
</Tip>
</Accordion>
</AccordionGroup>
</Step>
<Step title="Save Configuration">
After configuring your settings, close the provider configuration panel and click **Save** on the settings page to persist your changes.
Once saved, all organization members signed into the Cline extension will automatically use Anthropic with your configured settings. They won't be able to select other providers or switch to their personal Cline accounts.
<Warning>
Members can't switch to personal Cline accounts or join other organizations once remote configuration is enabled. This ensures consistent provider usage across your team.
</Warning>
</Step>
</Steps>
## Verification
To verify the configuration:
1. Check that the provider shows as "Anthropic" in the Enabled provider field
2. Confirm the settings persist after refreshing the page
3. Test with a member account to ensure they see only Anthropic as a provider
4. Verify that Claude models are available in the model dropdown
## Troubleshooting
**Members don't see the configured provider**
Ensure you clicked Save after closing the configuration panel. Verify the member account belongs to the correct organization.
**Connection errors when using a custom base URL**
Verify the proxy URL is correct and accessible from your team's development environments. Ensure the proxy correctly forwards requests to the Anthropic API.
**Configuration changes don't persist**
Make sure to click the Save button on the main settings page, not just close the configuration panel.
**Need to change settings later**
You can update the base URL or other settings at any time. Changes take effect immediately for all organization members.
For further details, consult the [Anthropic API documentation](https://docs.anthropic.com/) and coordinate with your infrastructure team.
@@ -0,0 +1,95 @@
---
title: "Configure Anthropic in VS Code (Members)"
sidebarTitle: "Configure Anthropic (Member)"
description: "Guide for engineers connecting to their organization's Anthropic provider through VS Code after admin setup"
---
As a team member, you can connect your local development environment to your organization's Anthropic provider setup. This guide walks you through configuring your API key in VS Code so you can start using Claude models through your organization's configuration. Your administrator has already configured the provider settings — you just need to add your API key to get started.
## Before You Begin
To successfully connect to your organization's Anthropic provider, you'll need a few things ready.
**Cline extension installed and configured**
The Cline extension must be installed in VS Code and you need to be signed into your organization account. If you haven't installed Cline yet, follow our [installation guide](/getting-started/installing-cline).
<Info>
**Quick Check**: Open the Cline panel in VS Code. If you see your organization name in the bottom left, you're signed in correctly.
</Info>
**Anthropic API key**
You need an API key from Anthropic to authenticate requests. Your organization may provide keys centrally or require you to create one through the [Anthropic Console](https://console.anthropic.com/).
<Note>
If you're unsure how to obtain an API key, check with your administrator about your organization's key provisioning process.
</Note>
## Configuration Steps
<Steps>
<Step title="Open Cline Settings">
Open VS Code and access the Cline settings panel using either of these methods:
- Click the settings icon (⚙️) in the Cline panel
- Click on the API Provider dropdown located directly below the chat area
</Step>
<Step title="Enter Your API Key">
1. Select or confirm the **Anthropic** provider is selected
2. Enter your Anthropic API key in the **API Key** field
3. If your administrator configured a custom base URL, it will already be set and locked
4. Click **Save** to store your credentials
<Tip>
API keys are stored locally and are only used by the Cline extension.
</Tip>
<Note>
The base URL setting is controlled by your administrator. If a custom proxy URL is configured, your API requests will be routed through it automatically.
</Note>
</Step>
<Step title="Verify Configuration">
After entering your API key, administrator-controlled settings (such as base URL) will be locked (shown with a lock icon 🔒) as they're managed by your organization.
</Step>
<Step title="Test the Connection">
Send a test message in Cline to verify your API key works correctly with the configured Anthropic endpoint.
<Tip>
**Testing Recommendation**
Try a simple test like "Hello" first to verify basic connectivity before starting development tasks.
</Tip>
</Step>
</Steps>
## Troubleshooting
**Anthropic not available as provider option**
Confirm you're signed into the correct Cline organization. Verify your administrator has saved the Anthropic configuration and that you have the latest version of the Cline extension.
**Authentication errors ("Invalid API Key" or "Unauthorized")**
Verify your API key is correct and active. Check the [Anthropic Console](https://console.anthropic.com/) to confirm your key status and that it has sufficient permissions.
**Connection errors or timeouts**
If your administrator configured a custom base URL (proxy), check with your IT team about network requirements. If using the default Anthropic endpoint, ensure you have internet access to `api.anthropic.com`.
**Models not available**
The available models depend on your Anthropic API plan and your organization's configuration. Contact your administrator if expected models are not available.
**Rate limit errors**
Your API key may have rate limits configured by Anthropic. If you encounter rate limit errors during normal use, contact your administrator about adjusting limits or managing key usage across the team.
## Security Best Practices
When working with your Anthropic API key:
- Keep your API key secure and do not share it
- Never store your API key in code or version control
- Report any suspected key compromise to your administrator immediately
- Regularly check the [Anthropic Console](https://console.anthropic.com/) for unusual usage patterns
For further details, consult the [Anthropic API documentation](https://docs.anthropic.com/) and coordinate with your organization's administrator.
@@ -0,0 +1,138 @@
---
title: "Configure OpenAI Compatible Provider (Admin)"
sidebarTitle: "Configure OpenAI Compatible (Admin)"
description: "This guide explains how administrators configure an OpenAI-compatible endpoint as the organization-wide LLM provider for Cline."
---
As an administrator, you can add an OpenAI-compatible endpoint as the organization-wide LLM provider for all Cline users through the hosted admin console. This covers any provider that exposes an OpenAI-compatible API, including Azure Foundry (Azure OpenAI), self-hosted inference engines (vLLM, TGI), and other compatible services.
## Before You Begin
To get started with setting up an OpenAI-compatible provider for your organization, you'll need a few items in place.
**Administrator access to the Cline Admin console**
You need admin privileges to enforce provider settings across your organization. If you can navigate to **Settings → Cline Settings** in the admin console at [app.cline.bot](https://app.cline.bot), you have the right access level.
**An OpenAI-compatible API endpoint**
You need a running endpoint that implements the OpenAI chat completions API. This could be:
- Azure Foundry (Azure OpenAI Service)
- A self-hosted inference engine (vLLM, text-generation-inference, etc.)
- Any third-party service with an OpenAI-compatible API
<Note>
If you're using Azure Foundry, you'll need your Azure OpenAI endpoint URL and optionally the API version. Work with your Azure administrator to ensure the endpoint is provisioned and accessible.
</Note>
**Endpoint URL and authentication details**
You'll need the base URL of your endpoint and any required authentication headers.
## Configuration Steps
<Steps>
<Step title="Access Cline Settings">
Navigate to [app.cline.bot](https://app.cline.bot) and sign in with your administrator account. Go to **Settings → Cline Settings**.
<Info>
You should see the provider configuration options if you have the correct admin access level.
</Info>
</Step>
<Step title="Enable Remote Provider Configuration">
Toggle on **Enable settings** to reveal the remote provider configuration options. This allows you to enforce provider settings across your organization.
</Step>
<Step title="Select OpenAI Compatible as the API Provider">
Open the **API Provider** dropdown menu and select **OpenAI Compatible**. This will open the configuration panel where you'll configure all your organization-wide settings.
</Step>
<Step title="Configure OpenAI Compatible Settings">
The configuration panel includes settings that control how the provider works for your organization:
<AccordionGroup>
<Accordion title="Base URL (required)">
Enter the base URL of your OpenAI-compatible endpoint. Examples:
- **Azure Foundry**: `https://your-resource.openai.azure.com`
- **Self-hosted vLLM**: `https://inference.yourcompany.com/v1`
- **Other compatible services**: The provider's API base URL
<Tip>
Use HTTPS endpoints in production for security. Ensure the URL is accessible from your team's development environments.
</Tip>
</Accordion>
<Accordion title="Custom Headers (optional)">
Add custom HTTP headers that will be included with every API request. This is useful for:
- Custom authentication schemes beyond API keys
- Routing headers for internal load balancers
- Organization or tenant identifiers required by your endpoint
Headers are configured as key-value pairs.
</Accordion>
<Accordion title="Azure API Version (optional — Azure Foundry only)">
If you're using Azure Foundry (Azure OpenAI), specify the API version string. For example: `2024-02-15-preview` or `2024-06-01`.
This field is only needed for Azure OpenAI deployments. Leave it empty for non-Azure endpoints.
<Note>
Check the [Azure OpenAI API version documentation](https://learn.microsoft.com/en-us/azure/ai-services/openai/reference) for available versions.
</Note>
</Accordion>
<Accordion title="Azure Identity Authentication (optional — Azure Foundry only)">
Enable this to use Azure Active Directory (Entra ID) token-based authentication instead of API keys. When enabled, members authenticate using their Azure AD credentials rather than a static API key.
This field is only relevant for Azure Foundry deployments.
</Accordion>
</AccordionGroup>
</Step>
<Step title="Save Configuration">
After configuring your settings, close the provider configuration panel and click **Save** on the settings page to persist your changes.
Once saved, all organization members signed into the Cline extension will automatically use the OpenAI Compatible provider with your configured settings. They won't be able to select other providers or switch to their personal Cline accounts.
<Warning>
Members can't switch to personal Cline accounts or join other organizations once remote configuration is enabled. This ensures consistent provider usage across your team.
</Warning>
</Step>
</Steps>
## Azure Foundry Configuration
For organizations using Azure Foundry (Azure OpenAI Service), use the following configuration:
1. **Base URL**: Your Azure OpenAI endpoint (e.g., `https://your-resource.openai.azure.com`)
2. **Azure API Version**: The API version to use (e.g., `2024-06-01`)
3. **Azure Identity Authentication**: Enable if your organization uses Azure AD for authentication instead of API keys
## Verification
To verify the configuration:
1. Check that the provider shows as "OpenAI Compatible" in the Enabled provider field
2. Confirm the settings persist after refreshing the page
3. Test with a member account to ensure they see only the OpenAI Compatible provider
4. Verify that configured models are available in the model dropdown
## Troubleshooting
**Members don't see the configured provider**
Ensure you clicked Save after closing the configuration panel. Verify the member account belongs to the correct organization.
**Connection errors to the endpoint**
Verify the Base URL is correct and accessible from your team's development environments. Check that any firewalls or security groups allow access from developer IP addresses.
**Azure authentication failures**
If using Azure Identity Authentication, verify that members' Azure AD accounts have the appropriate role assignments on the Azure OpenAI resource. If using API keys, verify the key is correctly entered by the member.
**Configuration changes don't persist**
Make sure to click the Save button on the main settings page, not just close the configuration panel.
**Need to change endpoint or settings later**
You can update these settings at any time. Changes take effect immediately for all organization members.
For Azure Foundry, consult the [Azure OpenAI Service documentation](https://learn.microsoft.com/en-us/azure/ai-services/openai/). For other OpenAI-compatible endpoints, refer to your provider's documentation.
@@ -0,0 +1,117 @@
---
title: "Configure OpenAI Compatible in VS Code (Members)"
sidebarTitle: "Configure OpenAI Compatible (Member)"
description: "Guide for engineers connecting to their organization's OpenAI-compatible endpoint through VS Code after admin setup"
---
As a team member, you can connect your local development environment to your organization's OpenAI-compatible endpoint. This guide walks you through configuring your credentials in VS Code so you can start using models through your organization's configured endpoint. Your administrator has already configured the provider settings — you just need to add your API key to get started.
## Before You Begin
To successfully connect to your organization's OpenAI-compatible endpoint, you'll need a few things ready.
**Cline extension installed and configured**
The Cline extension must be installed in VS Code and you need to be signed into your organization account. If you haven't installed Cline yet, follow our [installation guide](/getting-started/installing-cline).
<Info>
**Quick Check**: Open the Cline panel in VS Code. If you see your organization name in the bottom left, you're signed in correctly.
</Info>
**API key or credentials for your endpoint**
You need an API key or credentials to authenticate with your organization's configured endpoint. For Azure Foundry deployments using Azure Identity Authentication, your Azure AD credentials may be used instead.
<Note>
If you're unsure what credentials to use, check with your administrator or IT team about how your organization has configured access.
</Note>
## Configuration Steps
<Steps>
<Step title="Open Cline Settings">
Open VS Code and access the Cline settings panel using either of these methods:
- Click the settings icon (⚙️) in the Cline panel
- Click on the API Provider dropdown located directly below the chat area
</Step>
<Step title="Configure Your Credentials">
The authentication method depends on how your administrator configured the endpoint:
<AccordionGroup>
<Accordion title="API Key Authentication">
For most OpenAI-compatible endpoints:
1. Select or confirm the **OpenAI Compatible** provider is selected
2. Enter your API key in the **API Key** field
3. The base URL, custom headers, and other settings are preconfigured by your administrator
4. Click **Save** to store your credentials
<Tip>
API keys are stored locally and are only used by the Cline extension.
</Tip>
</Accordion>
<Accordion title="Azure Identity Authentication (Azure Foundry)">
If your organization uses Azure AD authentication:
1. Select or confirm the **OpenAI Compatible** provider is selected
2. Ensure you are signed into Azure in your development environment
3. The extension will use your Azure AD credentials automatically
4. No API key is needed when Azure Identity Authentication is enabled
<Note>
You may need the Azure Account extension or Azure CLI installed for credential resolution.
</Note>
</Accordion>
</AccordionGroup>
<Note>
The Base URL, custom headers, Azure API version, and Azure Identity settings are preconfigured by your administrator and do not need to be set in the extension.
</Note>
</Step>
<Step title="Verify Configuration">
After configuring your credentials, administrator-controlled settings will be locked (shown with a lock icon 🔒) as they're managed by your organization.
</Step>
<Step title="Test the Connection">
Send a test message in Cline to verify your credentials work correctly with the configured endpoint.
<Tip>
**Testing Recommendation**
Try a simple test like "Hello" first to verify basic connectivity before starting development tasks.
</Tip>
</Step>
</Steps>
## Troubleshooting
**OpenAI Compatible not available as provider option**
Confirm you're signed into the correct Cline organization. Verify your administrator has saved the configuration and that you have the latest version of the Cline extension.
**Authentication errors ("Access Denied" or "Invalid API Key")**
Verify your API key is correct and active. For Azure Foundry with Azure Identity Authentication, ensure you are signed into Azure in your development environment and that your account has the appropriate role assignments on the Azure OpenAI resource.
**Connection errors or timeouts**
The endpoint URL is configured by your administrator. If you experience connection issues, check with your IT team about network requirements (VPN, firewall rules, etc.).
**Models not available**
The available models depend on your organization's endpoint configuration. Contact your administrator if expected models are not available in the model dropdown.
**Configuration changes don't persist**
Make sure to save your credentials. The base URL and other admin-controlled settings cannot be changed locally.
## Security Best Practices
When working with your API credentials:
- Keep your API key secure and do not share it
- Never store credentials in code or version control
- Report any suspected key compromise to your administrator immediately
- Follow your organization's usage guidelines for the configured endpoint
Your organization administrator controls which endpoint, models, and settings are available. The extension will automatically apply the configured settings based on your organization's remote configuration.
For Azure Foundry, refer to the [Azure OpenAI Service documentation](https://learn.microsoft.com/en-us/azure/ai-services/openai/). For other endpoints, consult your organization's internal documentation or contact your administrator.
@@ -1,11 +1,11 @@
---
title: "SaaS Provider Configuration"
title: "Enterprise Provider Configuration"
sidebarTitle: "Overview"
description: "Configure inference providers through the Cline hosted admin console for centralized organization management"
---
SaaS Provider Configuration allows administrators to centrally configure inference providers for their entire organization through the Cline hosted admin console. This approach ensures consistent provider access, security policies, and cost management across all team members without requiring individual developer setup or infrastructure deployment.
Remote Provider Configuration allows administrators to centrally configure inference providers for their entire organization through the Cline hosted admin console. This approach ensures consistent provider access, security policies, and cost management across all team members without requiring individual developer setup or infrastructure deployment.
## How Remote Configuration Works
@@ -35,11 +35,17 @@ Cline supports remote configuration for the following inference providers:
| Provider | Use Case | Configuration | Member Setup |
|----------|----------|---------------|--------------|
| **Cline** | Organizations using Cline's native provider with centralized API key management | API provider selection, model access | No individual API keys needed - fully managed by organization |
| **Amazon Bedrock** | Organizations using AWS infrastructure | Region selection, VPC endpoints, cross-region inference, prompt caching | AWS credential configuration in VS Code |
| **LiteLLM** | Organizations requiring multi-model access through a unified proxy | Proxy endpoint, authentication, model routing | API key or endpoint configuration in VS Code (or centralized with Master Key) |
| **Google Vertex AI** | Organizations using Google Cloud Platform | Project ID, region selection, model access | Service account or credential configuration in VS Code |
| **Cline** | Organizations using Cline's native provider with centralized API key management | API provider selection, model access | No individual API keys needed fully managed by organization |
| **Amazon Bedrock** | Organizations using AWS infrastructure | Region selection, VPC endpoints, cross-region inference, global inference, prompt caching | AWS credential configuration (API key, CLI profile, or credential chain) |
| **Google Vertex AI** | Organizations using Google Cloud Platform | Project ID, region selection, model access | Google Cloud credential configuration (service account, SDK, or ADC) |
| **Azure Foundry** | Organizations using Azure OpenAI or Azure AI services | Base URL, Azure API version, Azure identity authentication, custom headers | API key configuration in the extension |
| **Anthropic** | Organizations using the Anthropic API directly | Optional custom base URL for proxy deployments, model access | API key configuration in the extension |
| **OpenAI Compatible** | Organizations using any OpenAI-compatible endpoint (self-hosted, vLLM, custom proxies) | Base URL, custom headers, model access | API key configuration in the extension |
| **LiteLLM** | Organizations requiring multi-model access through a unified proxy | Proxy endpoint, authentication, model routing | API key or endpoint configuration (or centralized with Master Key) |
<Note>
**Azure Foundry** uses the OpenAI Compatible provider configuration with Azure-specific settings (API version, Azure identity authentication). See the [OpenAI Compatible admin configuration](/enterprise-solutions/configuration/remote-configuration/openai-compatible/admin-configuration) for setup instructions.
</Note>
## Configuration Process
@@ -55,7 +61,7 @@ Provider configuration is automatically distributed to all organization members
</Step>
<Step title="Member Credential Setup">
Team members add their individual credentials (API keys, AWS profiles, etc.) to connect to the configured provider.
Team members add their individual credentials (API keys, AWS profiles, etc.) to connect to the configured provider. For some providers like Cline and LiteLLM (with Master Key), no individual credentials are needed.
</Step>
<Step title="Immediate Access">
@@ -92,11 +98,19 @@ Select your provider below to begin the configuration process:
AWS-based AI models with enterprise security and compliance features.
</Card>
<Card title="Google Vertex AI" icon="google" href="/enterprise-solutions/configuration/remote-configuration/google-vertex/admin-configuration">
Google Cloud's AI platform with Gemini models and regional control.
</Card>
<Card title="OpenAI Compatible" icon="plug" href="/enterprise-solutions/configuration/remote-configuration/openai-compatible/admin-configuration">
Any OpenAI-compatible endpoint, including Azure Foundry.
</Card>
<Card title="Anthropic" icon="robot" href="/enterprise-solutions/configuration/remote-configuration/anthropic/admin-configuration">
Direct access to Anthropic's Claude models with optional proxy routing.
</Card>
<Card title="LiteLLM" icon="layer-group" href="/enterprise-solutions/configuration/remote-configuration/litellm/admin-configuration">
Unified proxy for accessing 100+ AI models through a single interface.
</Card>
<Card title="Google Vertex AI" icon="google" href="/enterprise-solutions/configuration/remote-configuration/google-vertex/admin-configuration">
Google Cloud's AI platform with advanced ML capabilities and global infrastructure.
</Card>
</CardGroup>
@@ -0,0 +1,155 @@
---
title: "OpenTelemetry Environment Variables"
sidebarTitle: "OpenTelemetry Override"
description: "Configure OpenTelemetry using environment variables for advanced scenarios"
---
<Note>
This is an **advanced configuration method**. Most users should use [Remote Configuration](/enterprise-solutions/monitoring/opentelemetry) via the dashboard instead.
</Note>
Environment variables provide an alternative way to configure OpenTelemetry, useful for self-hosted deployments, local development, CI/CD pipelines, or when you need to override organization settings.
## When to Use
- **Self-hosted deployments** without dashboard access
- **Local development and testing** with your own collectors
- **CI/CD pipelines** that need observability
- **Override organization settings** with user-specific configuration
<Warning>
Environment variable configuration bypasses user telemetry settings and will export data regardless of individual preferences.
</Warning>
## Environment Variables
### Core Configuration
| Variable | Description | Values |
|----------|-------------|--------|
| `CLINE_OTEL_TELEMETRY_ENABLED` | Enable OpenTelemetry export | `"true"` or `"false"` |
| `CLINE_OTEL_METRICS_EXPORTER` | Metrics exporters (comma-separated) | `"console"`, `"otlp"` |
| `CLINE_OTEL_LOGS_EXPORTER` | Logs exporters (comma-separated) | `"console"`, `"otlp"` |
### OTLP Configuration
| Variable | Description | Values |
|----------|-------------|--------|
| `CLINE_OTEL_EXPORTER_OTLP_PROTOCOL` | OTLP protocol | `"grpc"`, `"http/json"`, or `"http/protobuf"` |
| `CLINE_OTEL_EXPORTER_OTLP_ENDPOINT` | OTLP collector endpoint (applies to both metrics and logs) | URL with optional port |
| `CLINE_OTEL_EXPORTER_OTLP_HEADERS` | Authentication headers (comma-separated `key=value` pairs) | `"key=value,key2=value2"` |
| `CLINE_OTEL_EXPORTER_OTLP_INSECURE` | Disable TLS for gRPC (local development only) | `"true"` |
### Advanced OTLP Configuration
For separate metrics and logs endpoints:
| Variable | Description |
|----------|-------------|
| `CLINE_OTEL_EXPORTER_OTLP_METRICS_PROTOCOL` | Metrics-specific protocol override |
| `CLINE_OTEL_EXPORTER_OTLP_METRICS_ENDPOINT` | Metrics-specific endpoint |
| `CLINE_OTEL_EXPORTER_OTLP_LOGS_PROTOCOL` | Logs-specific protocol override |
| `CLINE_OTEL_EXPORTER_OTLP_LOGS_ENDPOINT` | Logs-specific endpoint |
### Export Tuning
| Variable | Description | Default |
|----------|-------------|---------|
| `CLINE_OTEL_METRIC_EXPORT_INTERVAL` | Milliseconds between metric exports | 60000 |
| `CLINE_OTEL_LOG_BATCH_SIZE` | Maximum batch size for log records | 512 |
| `CLINE_OTEL_LOG_BATCH_TIMEOUT` | Maximum time before exporting logs (ms) | 5000 |
| `CLINE_OTEL_LOG_MAX_QUEUE_SIZE` | Maximum queue size for log records | 2048 |
## Quick Start Examples
### Datadog with gRPC
```bash
export CLINE_OTEL_TELEMETRY_ENABLED=true
export CLINE_OTEL_METRICS_EXPORTER=otlp
export CLINE_OTEL_LOGS_EXPORTER=otlp
export CLINE_OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export CLINE_OTEL_EXPORTER_OTLP_ENDPOINT=https://api.datadoghq.com:4317
export CLINE_OTEL_EXPORTER_OTLP_HEADERS="dd-api-key=YOUR_API_KEY"
code .
```
<Note>
The endpoint shown above is for Datadog's **US1 region**. If you're in a different region (EU, US3, US5, AP1, etc.), replace `api.datadoghq.com` with your region-specific hostname (e.g., `api.datadoghq.eu` for EU). See [Datadog's OTLP documentation](https://docs.datadoghq.com/opentelemetry/) for your region's endpoint.
</Note>
### New Relic with HTTP
```bash
export CLINE_OTEL_TELEMETRY_ENABLED=true
export CLINE_OTEL_METRICS_EXPORTER=otlp
export CLINE_OTEL_LOGS_EXPORTER=otlp
export CLINE_OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
export CLINE_OTEL_EXPORTER_OTLP_ENDPOINT=https://otlp.nr-data.net:4318
export CLINE_OTEL_EXPORTER_OTLP_HEADERS="api-key=YOUR_LICENSE_KEY"
code .
```
### Local Development (Insecure)
```bash
export CLINE_OTEL_TELEMETRY_ENABLED=true
export CLINE_OTEL_METRICS_EXPORTER=otlp
export CLINE_OTEL_LOGS_EXPORTER=otlp
export CLINE_OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export CLINE_OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
export CLINE_OTEL_EXPORTER_OTLP_INSECURE=true
code .
```
### Console Output (Testing)
```bash
export CLINE_OTEL_TELEMETRY_ENABLED=true
export CLINE_OTEL_METRICS_EXPORTER=console
export CLINE_OTEL_LOGS_EXPORTER=console
code .
```
## Debugging
Enable detailed OpenTelemetry diagnostic logging:
```bash
export TEL_DEBUG_DIAGNOSTICS=true
code .
```
This outputs:
- Configuration being used
- Exporters being created
- Connection attempts
- Export successes/failures
Check the VS Code Developer Tools Console (Help > Toggle Developer Tools) for diagnostic output.
## Configuration Priority
When multiple configuration methods are present, Cline uses this priority order:
1. **Environment variables** (highest priority) - This method
2. **Remote Configuration** - Dashboard settings
3. **Default settings** - Built-in defaults
Environment variable configuration will override dashboard settings.
## See Also
<CardGroup cols={2}>
<Card title="Dashboard Configuration" icon="globe" href="/enterprise-solutions/monitoring/opentelemetry">
Configure OpenTelemetry via the web dashboard
</Card>
<Card title="Remote Configuration" icon="server" href="/enterprise-solutions/configuration/remote-configuration/overview">
Learn about Remote Configuration system
</Card>
</CardGroup>
@@ -199,8 +199,7 @@ Understanding how seats work helps you manage your license effectively:
<Accordion title="Upgrading Your License" icon="arrow-up">
Need more seats?
- **Teams Plan:** Contact your account manager or visit app.cline.bot/settings/billing to upgrade your license.
- **Enterprise Plan:** Includes unlimited seats with no per-user restrictions.
- **Enterprise Plan:** Includes unlimited seats with no per-user restrictions. Contact your account manager or visit app.cline.bot/settings/billing to upgrade.
</Accordion>
</AccordionGroup>
-91
View File
@@ -1,91 +0,0 @@
---
title: "Explain Changes"
sidebarTitle: "Explain Changes"
description: "Generate AI-powered inline explanations for any git diff, right inside a multi-file diff view."
---
`/explain-changes` lets you point Cline at any set of git changes — a commit, a branch comparison, a PR, uncommitted work — and get AI-generated inline comments explaining what changed and why. The comments appear directly in a side-by-side diff view inside VS Code.
<Note>
This feature is only available in VS Code. It is not supported in the CLI or JetBrains environments.
</Note>
## How to Use It
Type `/explain-changes` in the Cline chat input, optionally followed by a description of what you want explained:
```
/explain-changes Explain the last commit
```
```
/explain-changes What changed between main and feature/auth?
```
```
/explain-changes Walk me through PR #42
```
If you don't provide any details, Cline defaults to analyzing uncommitted changes in your working directory.
### What Happens Next
1. **Cline gathers context** — It runs git or gh CLI commands to retrieve the diff, reads relevant files, and builds an understanding of the changes.
2. **Cline calls `generate_explanation`** — This opens a multi-file diff view and streams AI-generated inline comments explaining each change.
You'll see Cline working through these steps in the chat before the diff view opens.
## Git Reference Formats
Cline understands all standard git references. Here are common examples:
| What You Want | How to Ask |
|---|---|
| Last commit | `Explain the last commit` |
| Specific commit | `Explain commit abc1234` |
| Commit range | `Explain changes from abc1234 to def5678` |
| Branch comparison | `What changed between main and feature/auth?` |
| Pull request | `Explain PR #42` |
| Uncommitted changes | `Explain my current changes` |
| Staged changes | `Explain what I've staged` |
| Tag comparison | `What changed between v1.0 and v2.0?` |
Under the hood, this translates to git refs like commit hashes, branch names, tags, and relative references (`HEAD~1`, `HEAD^`, `origin/main`, etc.).
## Understanding the Output
### Multi-File Diff View
Cline opens a side-by-side diff view in VS Code showing the before and after state of each changed file. Inline comments are attached to the specific lines they explain.
### Streaming Comments
Comments appear in real-time as the AI generates them. For smaller diffs (12 files), the diff view opens immediately and comments stream in. For larger diffs (3+ files), Cline cycles through each file individually to show comments as they arrive, then opens the combined multi-file diff view at the end.
### Interactive Replies
Each comment thread is interactive — you can reply to ask follow-up questions about a specific change. Cline will respond with additional context about that code section. If you need Cline to actually modify code based on the discussion, each comment thread has an **"Add to Cline Chat"** button that sends the conversation to the main Cline agent.
## Checkpoint-Based Explanations
Beyond the slash command, you can also trigger Explain Changes from **checkpoint messages** within a task. When Cline creates checkpoints during a task, each checkpoint message has an option to explain the changes made since the previous checkpoint. This uses the same diff view and inline comments but compares checkpoint hashes rather than git refs.
## Use Cases
- **Code review** — Understand what a PR or commit does before approving it
- **Onboarding** — Explore unfamiliar codebases by explaining recent changes
- **Learning** — See explanations of how specific patterns or features were implemented
- **Debugging** — Understand what changed between a working and broken state
- **Documentation** — Generate explanations you can reference later when maintaining code
## Tips
- **Provide context in your prompt.** The more specific you are ("Explain the auth changes in PR #42"), the more focused Cline's investigation will be.
- **Use `@` mentions.** Point Cline at specific files to give it additional context before generating explanations.
- **Reply to comments.** The interactive threads let you dig deeper into any change you don't fully understand.
## Related
- [Using Commands](/core-workflows/using-commands) — All available slash commands
- [Checkpoints](/core-workflows/checkpoints) — Git-based snapshots of your project during tasks
- [Plan & Act Mode](/core-workflows/plan-and-act) — Cline's dual-mode system for structured development