Документация▌

Лёгкая IDE в стиле IntelliJ IDEA для проектов на этом компьютере, на серверах по SSH и в WSL. Код пишет агент в терминале, вы смотрите, правите и коммитите.

## Начало работы

Файлы — на странице загрузки (после входа; доступ по приглашению). Выберите свою систему:

› Windows 10 / 11

  1. Скачайте sreda-…-windows-x64-setup.exe и запустите. Установщик спросит «Install sreda for this user?» — права администратора не нужны: sreda встанет в %LOCALAPPDATA%\Programs\sreda, появятся ярлыки в «Пуске» и на рабочем столе, команда sreda в новых терминалах и строка в «Параметры → Приложения» (там же удаление). Файл не подписан, поэтому SmartScreen может спросить: «Подробнее» → «Выполнить в любом случае».
  2. Если нет Git for Windows, установщик предложит поставить его (через winget): он нужен для git и для доступа к компьютеру с телефона.
  3. Новая версия — так же: запустите новый setup поверх.
  4. Стартовый экран — окно Connections: «This device» (папки Windows), ваши SSH-серверы и установленные дистрибутивы WSL. Alt+Insert — новое SSH-подключение. Другой диск — в «Open Folder…» кнопка «↑ Up» из корня диска показывает все диски.

Без установки: sreda-…-windows-x64.exe — та же программа, запускается откуда угодно.

# из cmd / PowerShell тоже можно
sreda.exe C:\work\app                 # папка Windows
sreda.exe wsl:Ubuntu:~/app            # проект внутри WSL
sreda.exe dev:/srv/app                # по SSH

Настройки: %APPDATA%\prodev\config.toml, журналы — %APPDATA%\prodev\logs\. Ключи и ~/.ssh/config берутся из C:\Users\вы\.ssh\.

› Linux

Установка одной командой (x86_64):

curl -fsSL https://sreda.sistemabureau.ru/install.sh | sh

Скрипт покажет код: откройте сайт, войдите и подтвердите его. После этого он скачает последнюю версию, проверит SHA-256 и поставит sreda и sreda-web в ~/.local/bin, а на рабочем столе ещё и добавит ярлык в меню. Без входа на сайт ничего не скачивается. Компьютер появится на странице устройства, там же его можно отозвать.

Обновление: sreda update (или F1 → Install Update; повторный запуск той же команды установки тоже обновит).

Вручную: скачайте архив на странице загрузки, затем tar xzf sreda-*-linux-x86_64.tar.gz && cp sreda-*/sreda* ~/.local/bin/.

sreda                            # стартовый экран: подключения и проекты
sreda ~/work/app                 # папка на этом компьютере
sreda dev:/srv/app               # по SSH (алиас из ~/.ssh/config)
sreda -w ~/work/app              # своё окно из терминала: все клавиши IDEA

Из терминала sreda работает прямо в нём, с рабочего стола — в своём окне (Wayland и X11). Нужен git; для поиска быстрее всего с ripgrep. Настройки: ~/.config/prodev/config.toml.

› Android

  1. Скачайте .apk прямо на телефоне и откройте его; разрешите установку из этого источника. Новая версия ставится поверх старой, данные сохраняются.
  2. В приложении: «Ключ устройства» → скопируйте публичный ключ в ~/.ssh/authorized_keys на сервере (или войдите по паролю — его можно сохранить).
  3. Добавьте подключение и откройте проект. SSH работает прямо с телефона — компьютер-посредник не нужен.

Над клавиатурой — панель клавиш терминала (Ctrl, Esc, Tab, стрелки…). Терминал прокручивается свайпом, «Назад» закрывает диалоги. На планшете в альбомной ориентации — раскладка как в IDE.

› iPhone / iPad

Отдельного приложения пока нет — используйте веб-версию: запустите sreda-web на своём компьютере или сервере (см. ниже), откройте ссылку в Safari и «Поделиться → На экран Домой». С внешней клавиатурой работают клавиши IDEA.

› Сервер и веб-версия

На серверах, к которым вы подключаетесь, ничего ставить не нужно — только git и, чтобы терминалы переживали обрыв связи, tmux:

sudo apt install git tmux ripgrep      # Debian / Ubuntu
sudo dnf install git tmux ripgrep      # Fedora / RHEL

Веб-версия (браузер, планшет, телефон) встроена в sreda, отдельной программы нет: в sreda F1 → Open in Browser откроет текущий проект в браузере. Или из командной строки (Linux, macOS, Windows):

sreda web --open                                # на этом компьютере, откроет браузер
sreda web --listen 0.0.0.0:7777 dev:/srv/app    # доступ с других устройств: только в доверенной сети (HTTP без шифрования)

Сервер печатает ссылку с одноразовым токеном — откройте её на устройстве. TLS не встроен: снаружи давайте доступ через VPN (Tailscale, WireGuard) или SSH-туннель.

## Подключения и SSH

  • Окно Connections (стартовый экран, Ctrl+O): подключения с именами, у каждого свой список проектов. Enter — открыть, «+ Open Folder…» — новая папка, Alt+Insert — новое подключение, F4 — изменить.
  • Вход: ключ устройства (кнопка в окне), ssh-agent, ключи из ~/.ssh, пароль. Алиасы из ~/.ssh/config подхватываются сами.
  • Пароли хранятся зашифрованно; ключ шифрования — в системном хранилище (Windows Credential Manager, GNOME Keyring / KWallet, Android Keystore).
  • Обрыв связи — переподключение само, в строке состояния «⟳ Reconnecting…».

## WSL (Windows)

Проекты внутри Linux на Windows — как в IDEA и VS Code: git, поиск и терминалы работают в самом дистрибутиве, файлы открываются через \\wsl.localhost\<дистрибутив>.

wsl --install -d Ubuntu                   # если WSL ещё нет (PowerShell от администратора)
sudo apt install git tmux ripgrep         # внутри дистрибутива

Установленные дистрибутивы появляются в окне Connections как «Ubuntu (WSL)» и в выборе хоста при открытии папки. Из командной строки: sreda.exe wsl:Ubuntu:~/app. Держите проекты в файловой системе Linux (~/…), а не в /mnt/c — так git и сборка в разы быстрее.

## Свой компьютер с телефона или другого компьютера

Откройте доступ к компьютеру один раз — и работайте с ним с телефона или другого компьютера: файлы, git, терминалы, агенты. Компьютер может быть дома или в закрытой сети: не нужны ни SSH-сервер, ни открытые порты, ни VPN, ни команды. Связь идёт через этот сайт с шифрованием от устройства до компьютера.

Нужно: sreda на компьютере (Linux, macOS или Windows; на Windows ещё Git for Windows) и на втором устройстве (приложение на Android, sreda на другом ПК или веб-версия), один аккаунт на этом сайте.

› 1. На компьютере: «Open Access to This Computer»

В sreda: F1 → Open Access to This Computer…; в веб-версии — на стартовом экране.

  1. Шаг 1 — добавить компьютер в аккаунт. На экране QR и код: отсканируйте QR телефоном (или откройте ссылку) и нажмите «подтвердить» на сайте. Если компьютер уже добавлен, шаг пропускается.
  2. Шаг 2 — QR-код подключения и рядом короткий код вида ABCD-EFGH. Действуют 10 минут и только один раз.

› 2. На телефоне или другом компьютере: «Connect to a Remote Device»

В приложении и веб-версии — на стартовом экране: «New Connection» → «Computer with sreda»; в sreda — F1 → Connect to a Remote Device… или Connections → New Connection.

  1. Шаг 1 — добавить это устройство в тот же аккаунт (так же: код → «подтвердить» на сайте). Если уже добавлено — пропускается.
  2. Шаг 2 — «Scan QR»: наведите камеру на QR с экрана компьютера. Подключено сразу, на компьютере ничего нажимать не надо.
    Нет камеры — введите код с экрана. Тогда на обоих экранах появится одинаковый 6-значный код: сверьте его и нажмите на компьютере Allow.

Компьютер появится в списке подключений. Откройте его — и выбирайте папку проекта, как на своём устройстве.

› Дальше — само

  • Один раз и навсегда. QR больше не нужен: подключение запомнено, после обрыва связи восстанавливается само.
  • Работает, даже когда sreda на компьютере закрыт. После первого подключения доступ остаётся включённым и запускается при входе в систему (Linux — служба systemd пользователя, macOS — launchd, Windows — задача Планировщика без окна консоли). Выключить — переключатель «Keep access on when sreda is closed» в том же окне.
  • Dev-сервер компьютера на телефоне. F1 → Ports…: порты, которые слушает компьютер (например, localhost:5173), «Forward» — и страница открывается на устройстве.
  • Ещё одно устройство — ещё раз шаги 1–2 на нём; QR каждый раз новый.

› Отозвать доступ

  • На компьютере: «Open Access to This Computer» → список устройств → Revoke. Открытые соединения этого устройства закрываются сразу.
  • С любого устройства: страница устройства → «отозвать» (потерянный телефон — так).

› Почему это безопасно

  • Сайт ничего не видит. Между устройством и компьютером сквозное шифрование (протокол Noise), внутри него SSH. Сайт только пересылает зашифрованные байты.
  • Секрет QR не уходит на сайт. Ссылка из QR (sreda://pair…) не открывается в браузере, и сайт её не видит. Поэтому по QR — без подтверждения.
  • Код с экрана проходит через сайт, поэтому по коду устройство пускается только после Allow на компьютере со сверкой 6 цифр: даже взломанный сайт не подставит себя посередине.
  • Компьютер пускает только свои устройства — по ключу, сохранённому при сопряжении на самом компьютере. Без паролей; список меняется только на компьютере.
  • Компьютер нельзя подменить: его ключ закреплён на устройстве, чужой не пройдёт проверку ещё до SSH.

Даже полный взлом сайта не даёт доступа к компьютерам и данным: в худшем случае связь перестанет работать.

› Если не работает

… is offlineна компьютере нет интернета, или доступ выключен: откройте sreda → «Open Access to This Computer»
the QR or code may have expired or been usedQR и код действуют 10 минут и один раз — покажите новые
no such codeопечатка в коде, или устройства в разных аккаунтах — оба добавляйте в один
… did not allow this deviceпо коду нужно нажать Allow на компьютере, пока ждёт устройство
Windows: не запускаются команды и терминалыустановите Git for Windows

Серверы без экрана и тонкая настройка (соседние машины сети, команды sreda tunnel …) — sreda tunnel help.

## Терминалы и агенты

  • Alt+F12 — терминал, Ctrl+Shift+T — новая вкладка, Alt+A — терминал с агентом (claude, codex, gemini, aider — список в настройках).
  • Если на машине есть tmux, каждая вкладка — сессия tmux: связь оборвалась или sreda закрыт — агент продолжает работать, вкладка вернётся сама, в том числе на другом устройстве.
  • Закрытие вкладки спрашивает: завершить сессию или оставить работать в фоне. Без sreda: tmux ls, tmux attach -t prodev-….
  • Место на диске: sreda убирает за собой сама — индексы исчезнувших и давно не открывавшихся проектов, копии удалённых файлов, остатки обновлений; Settings → Storage (F1 → «Storage…») показывает, сколько где занято, и чистит сразу.
  • Доверие к папкам: git работает только в папках, которым вы доверяете — новая папка при первом открытии спрашивает (эту папку, всю папку выше или нет), до ответа проект открывается без git: настройки чужого репозитория (.git/config) могут заставить git запускать программы. Потом — F1 → «Trust Project…».
  • Терминалы этого компьютера и телефона sreda держит сама, где нет tmux (Windows, Android, Linux и macOS без tmux) — в своём фоновом процессе, он заканчивается сам, когда терминалов не остаётся.
  • Закрытие sreda (Ctrl+Q, крестик окна, в приложении — «Назад» → Exit) спрашивает, какие терминалы оставить работать: по умолчанию все, сначала те, где работает агент или сборка. Снятые завершаются; оставленные вернутся при следующем открытии проекта.
  • Дашборд агентов (F1 → «Agents Dashboard…», в веб-версии и приложении — «Agents» на стартовом экране): все агенты на этом компьютере и на машинах, к которым sreda подключена (SSH, туннель), кем бы они ни были запущены — из sreda, в терминале, tmux или в фоне. Кто ждёт подтверждения («waits for approval»), кто ждёт вас («your turn»), кто работает; последнее действие и запрос, папка, ветка, сколько файлов изменено. «Open» — открыть папку агента как проект, «Stop» (в терминале — Delete дважды) — остановить. Обновляется сам каждые 5 секунд.
  • Agent Sessions (Alt+Shift+A): сессии Claude Code и Codex проекта, в том числе запущенные не из sreda, — продолжить той же командой.

## Git

  • Commit (Alt+0, Ctrl+K): только изменённые репозитории, файлы по папкам, галочки, Amend, Commit and Push.
  • Push Ctrl+Shift+K, Update Project Ctrl+T, ветки Ctrl+Shift+` или клик по ветке в строке состояния.
  • Log Alt+9: граф, фильтры, cherry-pick, reset, revert. Diff — Ctrl+D, blame — правый клик по гаттеру.
  • Конфликты по местам: правый клик по конфликтному файлу → «Resolve Conflicts…» — ваша версия, база и их версия рядом; взять свою, их, обе или написать результат, затем «Save and Mark Resolved».
  • Интерактивный rebase: в логе на коммите → «Interactively Rebase from Here…» — pick, reword, edit, squash, fixup, drop и порядок коммитов; без редактора, на любой машине.
  • Несколько репозиториев в одной папке — все видны сразу. Есть GitLab: merge requests и пайплайны.

## Клавиши

Раскладка IntelliJ IDEA (Default keymap). Полный список — F1 → «Keymap Reference».

 Найти действие          Ctrl+Shift+A · F1
 Файл / недавние         Ctrl+Shift+N · Ctrl+E · Shift Shift
 Поиск по файлам         Ctrl+Shift+F
 Project / Commit / Log  Alt+1 / Alt+0 / Alt+9
 Терминал / агент        Alt+F12 / Alt+A
 Файлы: копия / вставка  Ctrl+C · Ctrl+X / Ctrl+V
 Commit / Push / Update  Ctrl+K / Ctrl+Shift+K / Ctrl+T
 Другой проект / выход   Ctrl+O / Ctrl+Q

Обычные терминалы забирают часть сочетаний (Ctrl+Shift+…). Вся раскладка работает в своём окне sreda (sreda -w, ярлык на рабочем столе), в kitty, WezTerm, Ghostty, Alacritty и в веб-версии — и при русской раскладке тоже. sreda --keys покажет, что доходит.

## Телефон и планшет

Файлы между компьютером и проектом. В дереве проекта Ctrl+C / Ctrl+X / Ctrl+V копируют и переносят файлы, в том числе между проектами на разных машинах. Файлы и папки с компьютера можно бросить на дерево (веб, своё окно sreda -w, терминал) или выбрать «Upload from This Device» — они окажутся на машине проекта, где бы она ни была; файл из дерева, брошенный на рабочий стол, скачивается.

Android-приложение и веб-версия — тот же функционал под пальцы: нижняя навигация (Файлы / Git / Поиск / Вкладки), диалоги-шторки, панель клавиш терминала, свайп для прокрутки терминала, предпросмотр Markdown по ширине экрана. На планшете — боковая панель и diff в две колонки.

## Настройки

F1 → «Open settings» открывает config.toml, изменения применяются при сохранении.

[ui]
theme = "prodev-dark"
agents = ["claude", "codex", "gemini", "aider"]
persistent_terminals = true        # терминалы в tmux

[[gitlab]]
url = "https://gitlab.com"
token = "glpat-…"                  # scope: api

[updates]
check = true                       # спрашивать о новой версии
auto = true                        # и ставить её самой

Журналы — ~/.config/prodev/logs/ (Windows: %APPDATA%\prodev\logs\): sreda.log, sreda-web.log, sreda-tunnel.log (служба туннеля). Подробнее — SREDA_LOG=debug. Секреты, ссылки и коды сопряжения туда не пишутся.

## Из любого браузера, без установки

Среда своего компьютера — в любом браузере: войдите на этот сайт, откройте «Устройства» и нажмите «войти» напротив компьютера.

  • Включается на компьютере. В окне «Open Access to This Computer» — «Allow access from a browser» (в TUI — клавиша b). По умолчанию выключено.
  • Первый раз из нового браузера компьютер спросит, пускать ли его, и покажет 6-значный код — тот же, что в браузере. Сверьте и нажмите Allow. Дальше этот браузер входит сразу; забыть его — «Forget» в том же окне.
  • Шифрование — от браузера до компьютера, как у приложения: сайт только пересылает данные. Но страницу среды отдаёт сайт, поэтому этот вход и выключен по умолчанию.

## Обновления

sreda раз в 6 часов спрашивает у этого сайта номер последней версии (и больше ничего не отправляет). Новая версия ставится сама:

  • Linux и Windows — sreda на компьютере, который добавлен на этот сайт, скачивает новую версию (проверяет её контрольную сумму и что она запускается) и кладёт на место старой. Служба доступа к компьютеру перезапускается в новую версию, как только к нему никто не подключён (терминалы при этом не закрываются). Окно и терминал показывают «⬆ sreda X is installed» — новая версия запустится при следующем запуске; в веб-версии на плашке есть кнопка «Restart».
  • Android — приложение скачивает новую версию, на плашке появляется «Install»: Android спросит, ставить ли её (один раз попросит разрешить приложению установку).

Проверить сразу: F1 → «Check for Updates». Только сообщать, не ставя: auto = false в [updates]; совсем не спрашивать: check = false. Вручную — как обычно, после входа на странице загрузок или командой sreda update.