Документация/Документация
Документация DevMachine
Что такое DevMachine, с чего начать и где прочитать о каждой возможности приложения и агента.
DevMachine — агент для разработки. Он встроен в приложение для macOS, Windows и Linux. Вы ставите задачу в чате, а агент читает проект, правит файлы и запускает команды прямо у вас на компьютере, в папке проекта. Рядом с чатом — редактор, терминал, Git-клиент, клиент баз данных и модули для работы с продакшеном: кластеры Kubernetes, очереди, логи и метрики.
Не пишете код? Хватит чата «Без проекта» для документов, таблиц и разовых скриптов.
Агент работает у вас, а к языковым моделям (нейросетям, которые пишут его ответы) обращается через сервер DevMachine. Поэтому из России VPN не нужен и платите вы в рублях. Новый аккаунт получает пробный период до 30 дней без карты, подробнее — Тарифы и лимиты.
С чего начать
- Быстрый старт — установить приложение, войти и поставить агенту первую задачу.
- Как устроен DevMachine — что происходит на вашем компьютере, а что на сервере.
- Модели — как выбрать модель, что делает модель «Авто» и как настроить уровень рассуждений.
- Переезд с Cursor, Claude Code и Codex — как перенести чаты, правила, навыки и привычные сочетания клавиш.
Начало работы
- Быстрый стартСкачать и установить приложение, войти в аккаунт, открыть проект, поставить агенту первую задачу и проверить правки.
- Как устроен DevMachineЧто работает у вас на компьютере, что идёт через сервер DevMachine и где хранятся проект, чаты и ключи к моделям.
- Установка и обновленияДля каких систем есть сборки DevMachine ADE, как установить приложение на macOS, Windows и Linux, как оно обновляется и как его удалить.
- ПроектыКак открыть папку проекта, начать без проекта, склонировать репозиторий и открыть файл из системы. Какие папки нельзя открыть как проект.
- Переезд с Cursor, Claude Code и CodexКак перенести чаты проекта, правила, навыки, MCP-серверы, сочетания клавиш и тему из Cursor, Claude Code и Codex.
Агент
- Как работает агентЧто происходит после вашего сообщения, как читать ленту чата, как остановить агента и что он делает сам, а о чём спрашивает.
- Сообщения и вложенияКак писать агенту, направлять его во время работы, прикладывать файлы, картинки и документы, цитировать ответы и переходить по ссылкам на файлы.
- Команды «/»Все встроенные команды поля ввода: что делает каждая и какие тратят лимит.
- Режимы агента«Авто», «Полный», «План» и «Без ограничений»: что агент в каждом режиме делает сам, о чём спрашивает и как переключить режим.
- Режим «План»Как договориться с агентом о плане до того, как он тронет код: вопросы, документ плана и карточка «План готов».
- FlowFlow — способ работы агента DevMachine: уточнить задачу, спланировать, написать тест раньше кода и проверить результат, прежде чем сказать «готово». Что он меняет и как его выключить.
- Разрешения и вопросы агентаКарточки, где агент просит разрешения или задаёт вопрос: что на них написано, что значит каждая кнопка и как отозвать «Больше не спрашивать».
- Изменения сессии, откат и ветвление чатаКак проверить правки агента и откатить файл, как отменить запрос вместе с его правками и отправить исправленным и как разветвить чат.
- Список чатов, поиск и параллельные задачиКак создавать, переименовывать, закреплять и удалять чаты, искать по ним и вести несколько задач агента одновременно.
- Задача в отдельной копии проектаКак дать каждой задаче агента свою копию проекта и свою ветку, чтобы несколько агентов работали параллельно и не мешали друг другу.
- Субагенты и фоновые задачиЧто такое субагенты, когда агент их запускает, где следить за ними и за запущенными серверами, на какой модели они работают.
- Инструменты агентаЧто значат строки действий агента в ленте, как работают веб-поиск, генерация картинок и браузер агента, где описаны инструменты модулей.
- Внешние агентыКак разрешить другой агентной системе ставить задачи агенту DevMachine на вашем компьютере, выдать ей ключ и следить за её работой.
- Голосовой вводКак надиктовать задачу агенту, где распознаётся речь и какие у диктовки пределы.
- Контекст, сжатие истории, расход и повторыЧто такое контекст агента, как следить за ним и за расходом лимита, как сжимается история, что делать при повторах и обрывах связи и как агент помнит проект между чатами.
Модели и тарифы
- МоделиКак выбрать модель для чата, что делает модель «Авто», как настроить уровень рассуждений и модель субагентов и почему свой API-ключ не нужен.
- Тарифы и лимитыЧто даёт пробный период, чем различаются тарифы, как устроены сроки оплаты, автопродление и пакеты лимита и что будет, когда лимит кончится.
- Аккаунт и веб-кабинетКак войти и выйти, что показывает раздел «Аккаунт и тариф», как работать в организации и зачем нужна каждая страница веб-кабинета devmachine.ai/console.
Настройка
- Окно настроекКак открыть настройки, что в каком разделе и как сменить тему, язык и расположение панелей.
- Сочетания клавишКак выбрать набор сочетаний — VS Code, JetBrains или JetBrains Classic — и какие клавиши в нём работают на macOS, Windows и Linux.
- Правила проекта: AGENTS.md и заметка о репозиторииРасскажите агенту один раз, как собирать проект и чего не трогать: файлом AGENTS.md в репозитории или заметкой в настройках.
- НавыкиНавык — инструкция с файлами и скриптами, которую агент берёт, когда задача подходит. Как поставить навык, вызвать его и написать свой.
- Свои команды и агентыСвои команды «/» и субагенты — Markdown-файлы в домашней папке. Как их создать и вызвать, как выбрать модель для субагентов.
- MCP-серверы: «Интеграции»Как подключить к агенту MCP-сервер — по адресу или командой, — выбрать, какие его инструменты получит агент, и включить подтверждение перед вызовом.
- ПлагиныПлагин добавляет в DevMachine свой экран и инструменты для агента. Как поставить плагин из папки, что проверить на экране установки, как выключить и удалить его.
- Модули агентаМодуль даёт агенту инструменты и инструкции для одной области, например для баз данных, кластеров или продакшена. Какие модули есть, что включено по умолчанию, сколько стоит каждый и как его включить.
- ОкруженияОкружение — общий стенд с базами, брокерами и кластерами. Привяжите к нему репозиторий, и агент в каждом новом чате будет знать, с чем работает.
Рабочее место
- Окно приложенияИз чего состоит окно DevMachine ADE: шапка, левая и правая колонки, центр. Как вынести модуль или настройки в отдельное окно, вернуться назад и найти пропущенное уведомление.
- Файлы, редактор и поискДерево файлов проекта, просмотр документов, PDF и картинок, редактор кода, поиск и замена в файле, общее окно поиска по чатам, файлам и тексту.
- Дифф «Код / Поведение»Изменение можно читать построчно или по смыслу, группами с уровнем риска. Второй способ помогает быстро понять, куда в большой правке агента смотреть первым делом.
- Git-клиент, аккаунты и публикацияВстроенный Git: статус, коммит, ветки, журнал с графом, rebase, cherry-pick, stash и worktree. Здесь же — Git-аккаунты, клонирование и публикация репозитория, а merge request открывает агент.
- ТерминалВстроенный терминал: вкладки, поиск, запуск команды из ответа агента одной кнопкой, окно макросов. Чем ваши команды в терминале отличаются от команд агента.
- Базы данныхКак в инструменте «БД» подключиться к PostgreSQL, MySQL, ClickHouse, MongoDB, 1С OData и другим базам, смотреть таблицы, выполнять запросы и править данные — и что с базами может агент.
- Браузер агентаВстроенный браузер: агент открывает в нём страницы и проверяет свою работу, а вы видите то же самое и в любой момент можете перехватить управление.
- Проект на сервере по SSHОкно приложения — на вашем компьютере, проект и агент — на Linux-сервере. Что нужно серверу и вам, как подключиться и что в таком проекте работает иначе.
- Доступ с телефонаКак следить за агентом и отвечать ему с телефона или из другого браузера, пока компьютер включён. По умолчанию доступ выключен.
- Разработка на 1СЧто DevMachine даёт разработчику 1С:Предприятия — навыки агента, проверка кода BSL, подключение 1С:EDT, выгрузка конфигуратора, данные базы через OData — и как это включить.
Продакшен
- Kubernetes: кластеры в приложенииКак смотреть и менять кластеры прямо в DevMachine через ваш kubectl и kubeconfig и как дать агенту читать и чинить их, с вашим подтверждением там, где это важно.
- Queues: очереди Kafka и RabbitMQКак в одном виде смотреть топики и очереди Kafka и RabbitMQ, группы потребителей с их отставанием, DLQ и сообщения — и как дать агенту доступ к брокерам на том уровне, который выберете вы.
- Ignition: API-клиентЗапросы к HTTP-API, коллекции, окружения, проверки и прогоны прямо в приложении. Всё лежит в папке .ignition/ рядом с кодом, а агент работает с теми же запросами.
- Observe: логи, трейсы, метрики и ошибкиКак подключить свой мониторинг — Prometheus, Loki или Elasticsearch, Tempo или Jaeger, Sentry или GlitchTip — и видеть, всё ли в порядке в продакшене и что именно сломалось.
- Incidents: инциденты продакшенаКак сбои продакшена становятся инцидентами с готовой задачей для агента или для вас и почему закрыть инцидент может только проверка продакшена.
- Rollout: выкатка через CanaryКак модуль Rollout выкатывает изменение по этапам через Argo Rollouts в вашем кластере, что для этого нужно и чего пока нельзя настроить из приложения.
- Profiler: профилированиеКак снять профиль сервиса под нагрузкой, найти горячие места и сравнить профили «до» и «после». Если агент говорит «стало быстрее», он должен подкрепить это таким сравнением.
- Макросы: проверенные команды проектаКоманды эксплуатации с параметрами: лежат в репозитории и проходят ревью как код. Вы запускаете их из формы с предпросмотром, агент — только проверенные, а всё рискованное — после вашего ответа.
Безопасность и данные
- Обзор безопасностиНа чём держится безопасность агента в DevMachine, где её настроить и с чего начать, если проект чужой или агент работает с продом.
- Ограничения агентаСтупени действий, наборы «Свободно», «Осторожно» и «Строго», песочница команд на macOS, Linux и Windows, сеть агента, что закрыто для него всегда и как задать свои исключения.
- Доступ агента к базам, кластерам и очередямКак задать уровень доступа агента к каждой базе данных, кластеру Kubernetes и брокеру сообщений, что значат метки окружений dev, stage и prod и какие действия вы подтверждаете на каждый вызов.
- Аварийная остановка и журнал действийКак одним сочетанием клавиш остановить агента вместе со всем, что он запустил, как включить его снова и где смотреть журнал всех его действий.
- Данные и приватностьЧто уходит с компьютера и через кого, что хранится на сервере DevMachine, что маскируется перед отправкой модели, а что нет.
- Организации и политика агентаКак команда работает по одной подписке: роли, участники и приглашения, что видят владелец и администраторы и как «Политика агента» ограничивает агента на компьютерах сотрудников.
- Для компаний: облако или контур заказчикаДва варианта для команд и компаний: облако DevMachine с организациями или установка целиком в вашу инфраструктуру, вплоть до сети без интернета.
Помощь
- Если что-то не работаетЧастые сбои и что с ними делать: связь с сервером, долгие ответы модели, вход, запуск агента, обновления и проекты. В конце — где найти журнал.
- ПоддержкаКак отправить отчёт об ошибке прямо из приложения и что в него попадает. Где найти версию и журнал приложения и как связаться с поддержкой.
Обновлено · Нашли неточность? Напишите на support@devmachine.ai или в Telegram.