Код и приложение в одном окне

Сверено с выпуском 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 этой вкладки и показывает приложение во встроенной рамке.

Как это устроено:

  1. Pulse выделяет свободный порт (или указанный вами) и передаёт его команде через переменную PORT; у каждого worktree — свой процесс и свой порт, поэтому две сессии одной задачи не мешают друг другу.
  2. Адрес берётся из вывода команды (строки вроде Local: http://localhost:5173); если команда его не печатает, Pulse ждёт, когда порт откроется.
  3. Между рамкой и приложением стоит локальный прокси Pulse на 127.0.0.1: он пропускает запросы и WebSocket (горячая перезагрузка работает), а в HTML-страницы добавляет маленький скрипт выбора элемента. Рамка не имеет привилегированного доступа к приложению — это обычная страница.
  4. Статус показывает состояние (запускается · работает · остановлен · не запустился), 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` |