# vscode-central-remote-config

**Repository Path**: mirrors_Orange-OpenSource/vscode-central-remote-config

## Basic Information

- **Project Name**: vscode-central-remote-config
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-24
- **Last Updated**: 2026-02-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VSCode Central Remote Configuration

![Logo CRC](https://raw.githubusercontent.com/Orange-OpenSource/vscode-central-remote-config/main/crc_icon.png "Logo CRC")

## Overview

[![Software License](https://img.shields.io/badge/license-MIT-informational.svg?style=for-the-badge)](https://spdx.org/licenses/MIT.html)
[![semantic-release: angular](https://img.shields.io/badge/semantic--release-angular-e10079?logo=semantic-release&style=for-the-badge)](https://github.com/semantic-release/semantic-release)

The **VSCode Central Remote Config extension** allows users to load and configure their [Continue](https://www.continue.dev/) settings from a remote server. This extension provides a simple way to manage `~/.continue/config.yaml` Continue configuration file, replacing placeholders with user-provided API key.

![CRC settings](https://raw.githubusercontent.com/fxsoubirou/vsc-crc-media/main/crc_settings.png "CRC Settings")

### Features

- Load configuration `<Config Label>` from the remote server `<Remote End Point>`.
- Automatically replace placeholders `<Api Key Pattern>` in the configuration file with user-provided API key `<Api Key>`.
- Edit settings and download remote configuration options from the status bar `CRC` icon.
- The `CRC` icon comes now with a tick or a cross to help the user identify if the local configuration is up to date.

### Installation

1. Open VSCode and navigate to the Extensions panel.
1. Search for "central-remote-config" in the Marketplace.
1. Click on the extension result to open its details page.
1. Click on the `Install` button to install the extension.

### Usage

1. Click on the `CRC` status bar item and select `Edit settings` to open the settings panel.
1. Update the configuration options as needed.

| Settings            | Description                                                                                                 |
| ------------------- | ----------------------------------------------------------------------------------------------------------- |
| Remote End Point    | The remote end-point of the remote configuration file.                                                      |
| Api Key             | The user API key that replaces the **Api Key Pattern** pattern in the remote configuration file. (Optional) |
| Config Label        | The name of the remote configuration file. Default value: `default.yaml`.                                   |
| Api Key Pattern     | The pattern to substitute in the remote configuration file. Default value: `__CRC_API_KEY__` .              |
| User Home Directory | Custom user home directory path. Leave empty for automatic detection.                                       |

1. Click on the `CRC` status bar item and select `Download remote configuration` to install the updated configuration file.

Example of a template remote configuration file:

```yaml

  models:
    - name: llama-3.2
      provider: ollama
      model: llama3.2:3b
      apiBase: https://model01.example.com:11434
      apiKey: __CRC_API_KEY__
      roles:
        - chat
  ...
```

## Contributing

### Make changes

- Press `F5` to open a new window with your extension loaded.
- You can relaunch the extension from the debug toolbar after changing code in `src/extension.ts`.
- You can also reload (`Ctrl+R` or `Cmd+R` on Mac) the VS Code window with your extension to load your changes.

### Run linters and tests

```shell
task ...
 npm run test
```

### Manual package and local test extension

```shell
npm run package
npm install -g @vscode/vsce
# Generate the `.vsix` file.
vsce package
```

Follow the [official documentation](https://code.visualstudio.com/api/working-with-extensions/publishing-extension#packaging-extensions) for more details on packaging and installing an extension without publishing it to the marketplace.

### Deployment

- Push code to Gitlab
- On new release, get vsix package from Gitlab releases page.
- Push code to [Github](https://github.com/Orange-OpenSource/vscode-central-remote-config)
- Publish extension to the [marketplace](https://marketplace.visualstudio.com/manage/publishers/orange-ospc)
- Verify publication on the marketplace.

## License

This software is distributed under the MIT License, see the LICENSE.txt file for more details or visit [https://spdx.org/licenses/MIT.html](https://spdx.org/licenses/MIT.html).

## Contributors

- FX Soubirou (Orange SA) - Initial work
- Omar Oumlala (Orange SA) - Additional features