Ensemble Code
Ensemble Code — расширение Visual Studio Code для работы с AI прямо в редакторе: чат с агентом, правки в файлах, автодополнение и поиск по коду. Подходит и для личной разработки на своём компьютере, и для команд с корпоративным сервером Ensemble.
Документация актуальна для Ensemble IDE 0.1.22 и Ensemble 0.6.25: полное руководство.
На русском
Что это такое
Ensemble Code подключает VS Code к платформе Ensemble. В боковой панели открывается чат с агентом, который видит ваш проект, может читать и менять файлы, запускать команды (с вашим разрешением), искать по кодовой базе и предлагать правки прямо в редакторе — без переключения в браузер.
Расширение рассчитано на повседневную разработку: объяснить код, найти место бага, внести правку, дописать функцию, подготовить коммит, пройтись по плану задач.
Два режима подключения
Личный (Ensemble Code)
Вы входите через аккаунт Ensemble и работаете с движком на своей машине. Можно подключить свои модели и endpoints (BYOK) — например OpenAI-совместимые провайдеры. Файлы и локальный индекс хранятся на вашем компьютере; выбранному провайдеру передаётся контекст запроса, а для облачных эмбеддингов — индексируемые фрагменты. Корпоративный сервер не требуется.
Корпоративный
IT выдаёт адрес сервера Ensemble и ключ доступа. Вы подключаетесь к инфраструктуре компании: общие модели, политики доступа, командная работа в рамках настроенного окружения.
Выбор режима делается при первом запуске и в настройках расширения.
Основные возможности
Чат и агент
Диалог в боковой панели. Агент отвечает в контексте открытого проекта (в том числе multi-root workspace с несколькими папками). Можно прикреплять файлы и выделенный код, открывать новые чаты, смотреть историю сессий.
Правки в редакторе
Предложения агента видны в коде. Можно принимать или отклонять изменения по файлу или целиком, смотреть diff. Удаления можно показывать прямо в редакторе или компактно — настраивается.
Next Edit и FIM
Пока вы пишете код, Ensemble предлагает следующую правку или продолжение: дописать строку, исправить фрагмент, заменить блок. Принятие — привычным Tab. Можно настроить модель, задержку, языки и поведение при простое курсора.
Поиск по кодовой базе
Агент может искать по смыслу («где реализован Next Edit?»), а не только по точному тексту. Для личной работы доступен локальный индекс; при подписке — также семантический поиск с эмбеддингами.
Планы
Отдельная панель планов: агент может вести пошаговый план задачи, а вы — следить за прогрессом и продолжать после паузы.
Разрешения и безопасность
Доступ за пределы открытых папок workspace, выполнение команд и чувствительные действия запрашивают подтверждение. Внутри открытых проектов работа идёт без лишних вопросов.
Прочее
Генерация сообщения коммита в Source Control, звуковые уведомления о завершении ответа или запросе разрешения, язык ответов агента (русский / английский), настройки моделей и индекса.
С чего начать
- Установите Ensemble Code из Marketplace.
- Откройте панель Ensemble в боковой панели VS Code.
- Выберите личный вход через Ensemble или корпоративный сервер (URL + ключ от IT).
- Расширение само скачает и запустит локальный мини-движок. Адрес
127.0.0.1 и порт показаны в нижней панели; нажмите на адрес, чтобы изменить порт. Для собственной сборки задайте абсолютный путь к исполняемому файлу в ensemble.enginePath. ensemble.localUrl нужен только для отдельно запущенного сервера; при автоматическом запуске оставьте его пустым.
- Откройте папку или workspace с проектом и начните чат.
Настройки Next Edit и FIM и индекса
Настраивайте включение и модели в расширении, а не в личном кабинете сайта. Auto использует ensemble-next-edit (Mercury Edit 2); можно выбрать выделенную модель или свою пользовательскую модель. Платные модели Ensemble требуют действующей подписки. Задержка по умолчанию — 100 мс, радиус правки — 5 строк. При 429 расширение учитывает паузу провайдера и пишет причину ожидания в журнал. Пустое предложение допустимо: модель не обязана менять каждую строку.
Индексатор исключает зависимости, окружения и результаты сборки. По умолчанию больше 2000 подходящих файлов требуют подтверждения перед облачными эмбеддингами. Пока подтверждения нет, работает текстовый поиск. Исключения и порог можно изменить в настройках; сохранённые векторы используются повторно после открытия проекта. Подробнее обо всех параметрах, разрешениях, просмотре изменений, MCP и диагностике — в руководстве.
Кому это полезно
- разработчикам, которым нужен AI в том же окне, где пишется код;
- тем, кто хочет свои модели и локальный контур без облака компании;
- командам на корпоративном Ensemble с единым сервером и политиками доступа.
Ссылки
Лицензия
MIT. См. LICENSE и THIRD_PARTY_NOTICES.
English
What it is
Ensemble Code connects Visual Studio Code to the Ensemble platform. You get a sidebar chat with an AI agent that can work with your project: read and edit files, run commands (with your approval), search the codebase, and suggest edits in the editor — without leaving VS Code.
It is built for day-to-day coding: explain code, locate a bug, apply a fix, finish a function, draft a commit message, or follow a multi-step plan.
Two connection modes
Personal (Ensemble Code)
Sign in with your Ensemble account and run against an engine on your own machine. You can bring your own keys and OpenAI-compatible endpoints (BYOK). Files and the local index stay on your computer. Request context is sent to your selected provider; cloud embeddings send indexed snippets to that provider. No company server is required.
Company
Your IT team provides an Ensemble server URL and an access key. You connect to the organization’s Ensemble deployment: shared models, access policies, and team workflows.
You choose the mode on first launch and can change it later in the extension settings.
Main features
Chat and agent
Sidebar conversations grounded in the open project, including multi-root workspaces. Attach files or selections, start new chats, and browse session history.
In-editor changes
Review agent edits in the editor: accept or reject per file or all at once, inspect diffs. Deleted lines can be shown inline or as compact markers — configurable.
Next Edit and FIM
While you type, Ensemble can propose the next edit or completion: finish a line, fix a snippet, or replace a block. Accept with Tab. Tune model, delay, languages, and idle behavior in settings.
Codebase search
The agent can search by meaning (“where is Next Edit implemented?”), not only exact strings. Personal use includes a local index; subscribed plans can also use semantic embeddings.
Plans
A dedicated Plans view for step-by-step agent plans so you can track progress and resume after an interruption.
Permissions and safety
Access outside your open workspace folders, shell commands, and sensitive actions ask for confirmation. Work inside open workspace folders stays friction-light.
Extras
Commit message generation in Source Control, optional sounds when a reply finishes or approval is needed, agent reply language (Russian / English), and model / index settings.
Getting started
- Install Ensemble Code from the Marketplace.
- Open the Ensemble view in the VS Code secondary sidebar.
- Choose personal Ensemble sign-in or a company server (URL + access key from IT).
- The extension downloads and starts its local mini-engine automatically. Click its loopback address in the status bar to change the port. For a custom build, set
ensemble.enginePath to the absolute executable path. Leave ensemble.localUrl empty for automatic startup; it is for separately managed servers.
- Open a project folder or workspace and start chatting.
Next Edit, FIM, and indexing
Enable features and select models in the extension, not the website account. Auto uses ensemble-next-edit (Mercury Edit 2); dedicated and custom models are supported. Paid Ensemble endpoints require an active subscription. Defaults: 100 ms delay and a five-line edit radius. Rate limiting pauses requests and records the wait in the log. An empty prediction is valid: the model does not have to edit every line.
The index excludes dependencies, environments, and build output. More than 2,000 eligible files requires approval for cloud embeddings by default; text search remains available before approval. Configure exclusions and the threshold in settings. Persisted vectors are reused when reopening a project. See the complete guide for permissions, change review, MCP, configuration, and troubleshooting.
Who it is for
- developers who want AI in the same window as their code;
- people who prefer their own models and a local setup without a company cloud;
- teams on corporate Ensemble with a shared server and access policies.
Links
License
MIT. See LICENSE and THIRD_PARTY_NOTICES.
