Работа в Promto
VS Code
Редактирование кода, терминал, запуск команд и работа со структурой проекта.
VS Code
Вкладка VS Code открывает code-server внутри текущего рабочего пространства. Это полноценный редактор для просмотра файлов, ручных изменений, поиска по репозиторию и работы со встроенным терминалом.
Первый запуск
- Откройте вкладку VS Code.
- Дождитесь запуска IDE. Первый запуск может занять до минуты.
- Рабочая папка
/home/userоткроется автоматически.
На компактном мобильном интерфейсе VS Code не отображается: используйте широкое окно или настольное устройство.
Основные действия
Открыть и изменить файл
- Найдите репозиторий в проводнике слева.
- Нажмите нужный файл.
- Внесите изменение.
- Сохраните файл сочетанием
Ctrl+SилиCmd+S.
Найти код
Используйте глобальный поиск VS Code, когда нужно найти использование функции, текст интерфейса или конфигурационный ключ. Перед массовой заменой просмотрите все найденные совпадения.
Выполнить команду
- Откройте встроенный терминал.
- Перейдите в каталог проекта.
- Запустите только проверенную команду.
- Дождитесь её завершения и прочитайте итоговый код выхода.
Для длительно работающего dev-сервера удобнее попросить агента запустить превью: он выберет свободный порт и зарегистрирует его в Promto.
Встроенный терминал VS Code или профессиональный терминал
Встроенный терминал VS Code — это shell-панель внутри редактора. Профессиональный терминал — отдельная вкладка рабочего стола с собственным PTY, восстановлением подключения и выбором Codex, Claude Code, Hermes Agent или OpenClaw.
Используйте терминал VS Code для короткой ручной команды рядом с кодом. Для долгой агентной сессии, нативного TUI или отдельного процесса удобнее профессиональный терминал.
Инструкции и CLI для агента
Отдельной focused-инструкции с topic vscode нет: VS Code здесь — интерфейс code-server, а не отдельный агент или CLI. Для работы с кодом главный агент выбирает инструкции по задаче:
- Promto Runtime Rules — topic
runtime; - Promto Tech Stack Rules — topic
tech_stack; - Promto Dev Server And Preview Rules — topic
dev_servers, если нужно запустить приложение; - Promto UI Markers And User-Facing Paths — topic
ui_markers, перед ссылками Preview или OpenFile; - Promto Git Integration Rules — topic
git, если задача включает clone, import или push.
Главный агент вызывает нужные встроенные инструкции точными командами get_instruction({ topic: "runtime" }), get_instruction({ topic: "tech_stack" }), get_instruction({ topic: "dev_servers" }), get_instruction({ topic: "ui_markers" }) и get_instruction({ topic: "git" }). Для портов и визуальной проверки он использует встроенные promto_port и promto_preview; команды проекта (git, менеджер пакетов, линтер, тесты и сборка) выполняет в shell только после изучения репозитория.
Во встроенном терминале VS Code терминальный агент начинает с promto instructions. Для Promto-действий доступны promto port owner <порт>, promto port free [начальный-порт], promto port list и promto preview screenshot --current --port <порт>. Эти команды терминала не заменяют focused-инструкции главного агента.
Готовый промпт для агента
Вызови get_instruction по темам runtime и tech_stack. Изучи репозиторий и его реальные команды, затем внеси изменение: <опишите задачу>. Не перезаписывай мои параллельные правки. Если понадобится dev-сервер, сначала загрузи dev_servers, выбери порт через promto_port и проверь результат через promto_preview. Перед финальной ссылкой на файл или превью загрузи ui_markers. Запусти релевантную проверку и укажи её результат.
Безопасная работа
- Перед крупными изменениями выполните
git status. - Не используйте команды удаления для широких или непроверенных путей.
- Не сохраняйте секреты в исходниках и документации.
- Не редактируйте служебные каталоги Promto.
- После изменений запускайте релевантные тесты или сборку.
- Не считайте файл сохранённым, пока вкладка редактора показывает несохранённые изменения.
Если IDE не загружается
Promto проверяет состояние code-server до 90 секунд. Если IDE не ответила, появится кнопка Попробовать снова.
- Нажмите Попробовать снова.
- Если ошибка повторяется, проверьте состояние рабочего пространства.
- Убедитесь, что пространство не остановлено и доступно.
- Не перезапускайте или не переустанавливайте среду без необходимости: сначала сохраните важные изменения и проверьте более узкие причины.