Документация▌
Лёгкая IDE в стиле IntelliJ IDEA для проектов на этом компьютере, на серверах по SSH и в WSL. Код пишет агент в терминале, вы смотрите, правите и коммитите.
## Начало работы
Файлы — на странице загрузки (после входа; доступ по приглашению). Выберите свою систему:
› Windows 10 / 11
- Скачайте
sreda-…-windows-x64-setup.exeи запустите. Установщик спросит «Install sreda for this user?» — права администратора не нужны: sreda встанет в%LOCALAPPDATA%\Programs\sreda, появятся ярлыки в «Пуске» и на рабочем столе, командаsredaв новых терминалах и строка в «Параметры → Приложения» (там же удаление). Файл не подписан, поэтому SmartScreen может спросить: «Подробнее» → «Выполнить в любом случае». - Если нет Git for Windows, установщик предложит поставить его (через winget): он нужен для git и для доступа к компьютеру с телефона.
- Новая версия — так же: запустите новый setup поверх.
- Стартовый экран — окно 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
- Скачайте
.apkпрямо на телефоне и откройте его; разрешите установку из этого источника. Новая версия ставится поверх старой, данные сохраняются. - В приложении: «Ключ устройства» → скопируйте публичный ключ в
~/.ssh/authorized_keysна сервере (или войдите по паролю — его можно сохранить). - Добавьте подключение и откройте проект. 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 — добавить компьютер в аккаунт. На экране QR и код: отсканируйте QR телефоном (или откройте ссылку) и нажмите «подтвердить» на сайте. Если компьютер уже добавлен, шаг пропускается.
- Шаг 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 — добавить это устройство в тот же аккаунт (так же: код → «подтвердить» на сайте). Если уже добавлено — пропускается.
- Шаг 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 used | QR и код действуют 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 ProjectCtrl+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.