Код и приложение в одном окне
Сверено с выпуском 0.36.0, 14.11.2026.
Вкладка «Файлы» на экране задачи (Сессия · Изменения · Граф задачи · Терминал · Файлы · Git) показывает worktree задачи и запущенное из него приложение рядом с чатом агента. Идея: посмотреть, что агент написал, поправить строку, увидеть результат в preview и ткнуть в элемент страницы, чтобы объяснить агенту, «вот это надо поправить», — не уходя из Pulse и не открывая пять окон.
Редактор — CodeMirror 6 с подсветкой синтаксиса, поиском и парой скобок; поверхность файла та же, что в разделе
«Файлы» (⌘ 8). Для серьёзной правки есть «Открыть на строке N» — тот же файл на той же строке в VS Code, Cursor
или Windsurf. Выделенные строки уходят в контекст сессии задачи по ⌘ L.
Во вкладке «Файлы» проекта путь окна — «проект / Файлы», а недавние файлы под «Файл не выбран» — только файлы этого проекта, его копий и сессий его задач; в общем разделе «Файлы» — все недавние.
Область действия: чей worktree
Каждая операция вкладки выполняется в явно названном worktree. Список «Место» в шапке вкладки: «Worktree — задача» или «Worktree — сессия «Тестировщик»», ниже — другие места и «Другая папка…». Правило:
- если в задаче выбрана изолированная сессия (со своей папкой и веткой, как у участников роя), вкладка работает с её папкой;
- иначе — с папкой задачи.
Сессия чужой задачи отвергается главным процессом («Сессия не принадлежит задаче»).
Все пути — относительные и внутри папки: .., абсолютные пути и символьные ссылки,
ведущие наружу, отклоняются до любого чтения или записи.
Список файлов и поиск
Список берётся из git ls-files --cached --others --exclude-standard: игнорируемые
файлы (node_modules, dist, сборки) не показываются. Если папка не репозиторий —
обход каталога без скрытых папок и node_modules/dist/out. Поиск по пути: подстрока
без учёта регистра, затем нечёткое совпадение (буквы по порядку). Не более 5000 записей;
строка внизу говорит «показано N из M».
Редактор и контроль версии файла
Файл открывается с отпечатком содержимого (sha1 как у git hash-object). Сохранение
(кнопка или ⌘S / Ctrl+S) отправляет текст вместе с отпечатком, который редактор видел:
- отпечаток совпал с тем, что на диске, — файл записан атомарно (временный файл + rename), права сохраняются;
- не совпал — агент или внешний редактор изменили файл после открытия: запись не выполняется, полоса над редактором говорит «Файл … изменён с момента открытия» и даёт «Сравнить», «Взять с диска» (свои правки теряются) или «Перезаписать своей версией» (явное решение человека: запись с актуальным отпечатком);
- папка занята ходом агента (аренда worktree, см. протокол занятости копий) — сохранение отклоняется с сообщением «В рабочей папке выполняется ход агента»; повторите после завершения хода.
Пока файл открыт, редактор следит за ним на диске (где слежение недоступно — сверяет раз в 4 секунды). Без несохранённых правок он молча подхватывает новую версию; с правками — полоса «Файл изменён на диске — <кто>, а у вас есть несохранённые правки» с «Взять с диска», «Сравнить» и «Оставить мою» и не перезаписывает ваш текст. Если правку сделал агент задачи, «На графе» ведёт к узлу этой правки.
Ограничения: двоичный файл показывается шестнадцатеричным видом и не редактируется; большой файл — кусками не больше 1 МБ (началом или концом) и только для чтения; строки с секретами маскируются.
Открыть во внешнем редакторе на строке
Кнопка «Открыть на строке N» использует CLI редактора (code --goto файл:строка, так же
cursor, windsurf). Если команды нет в PATH (типично на macOS без установки shell
command), файл открывается приложением без перехода к строке. Выбор редактора запоминается.
Preview: приложение из worktree
Правая панель запускает команду разработки (по умолчанию npm run dev, запоминается
на репозиторий) в worktree этой вкладки и показывает приложение во встроенной рамке.
Как это устроено:
- Pulse выделяет свободный порт (или указанный вами) и передаёт его команде через
переменную
PORT; у каждого worktree — свой процесс и свой порт, поэтому две сессии одной задачи не мешают друг другу. - Адрес берётся из вывода команды (строки вроде
Local: http://localhost:5173); если команда его не печатает, Pulse ждёт, когда порт откроется. - Между рамкой и приложением стоит локальный прокси Pulse на 127.0.0.1: он пропускает запросы и WebSocket (горячая перезагрузка работает), а в HTML-страницы добавляет маленький скрипт выбора элемента. Рамка не имеет привилегированного доступа к приложению — это обычная страница.
- Статус показывает состояние (запускается · работает · остановлен · не запустился), pid, порт, worktree и адрес; адрес открывается во встроенном браузере Pulse или во внешнем, «вывод» раскрывает хвост stdout/stderr.
Остановка — кнопка «Остановить» (процессу отправляется SIGTERM, через паузу SIGKILL). Удаление задачи и выход из Pulse останавливают её запуски. Preview не перезапускается сам после перезапуска Pulse: запуск — действие человека.
Выбор элемента → контекст для агента
«Выбрать элемент» переводит preview в режим выбора: наведение подсвечивает элемент, клик фиксирует его. Карточка внизу показывает селектор, текст и разметку. «В композер сессии» дописывает в черновик выбранной сессии блок:
Элемент страницы preview (http://127.0.0.1:5173/; worktree …/task-12):
- селектор: main > button.cta
- текст: «Купить»
- источник в коде не определён — найди по селектору и тексту
```html
<button class="cta">Купить</button>
Отправляет его человек — вкладка ничего не посылает агенту сама. Привязка к исходнику
(`- источник: src/App.tsx:42`) появляется, только когда приложение само помечает
элементы (`data-source`, атрибуты dev-плагинов React/Vue); иначе честно пишется, что
источник не определён, а не выдумывается.
Страница preview — чужой код (приложение и его зависимости), поэтому окно Pulse
принимает сообщение о выбранном элементе только пока включён режим выбора, только из
своего iframe и только с origin своего прокси; поля обрезаются до разумных пределов.
Остаточный риск: в режиме выбора скрипт страницы теоретически может подменить
содержимое карточки — текст в карточке взят со страницы, посмотрите его перед
«В композер сессии» и перед отправкой.
Похожий путь есть и во встроенном браузере Pulse: «Элемент → агент» отдаёт выбранный элемент встроенной сессии
или CLI-агенту во вкладке задачи — вставкой без Enter, запускаете вы
([контракт передачи](terminal/specs/browser-element-cli.md)).
## Раскладки
Переключатель в шапке: **Файлы** · **Файлы + Preview** · **Preview**. Выбор
запоминается. На узком окне панели становятся друг под другом.
## Что где в коде
| Слой | Файл |
|---|---|
| Файлы worktree: пути, список, чтение, запись с версией | `src/main/files/workspaceFiles.ts` |
| Запуск приложения, порт, адрес, прокси, остановка | `src/main/preview/devServer.ts`, `proxy.ts`, `picker.ts` |
| IPC: `pulse:files-list/file-read/file-write/open-editor-at/preview-*` | `src/main/ipc.ts` |
| Вкладка «Файлы», preview, карточка элемента | `src/renderer/src/components/files/FilesView.tsx` |
| Поверхность файла: редактор, полосы расхождения, внешний редактор | `src/renderer/src/components/files/FileViewer.tsx`, `files/surface/` |
| Черновик сессии (дописывание контекста) | `src/renderer/src/store.drafts.ts` |