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

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

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

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

WindowsLinuxAndroidiPhone / iPadСервер и веб-версия

› Windows 10 / 11

  1. Скачайте sreda-…-windows-x64.exe и положите в постоянную папку, например %LOCALAPPDATA%\sreda\. Ярлык на рабочий стол или в «Пуск» — по желанию.
  2. Запустите двойным кликом — откроется окно sreda. Файл не подписан, поэтому SmartScreen может спросить: «Подробнее» → «Выполнить в любом случае».
  3. Для проектов на этом компьютере нужен Git for Windows.
  4. Стартовый экран — окно Connections: «This device» (папки Windows), ваши SSH-серверы и установленные дистрибутивы WSL. Alt+Insert — новое SSH-подключение.
# из cmd / PowerShell тоже можно
sreda.exe C:\work\app                 # папка Windows
sreda.exe wsl:Ubuntu:~/app            # проект внутри WSL
sreda.exe dev:/srv/app                # по SSH

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

› Linux

tar xzf sreda-*-linux-x86_64.tar.gz
cd sreda-*-linux-x86_64
mkdir -p ~/.local/bin && cp sreda sreda-web ~/.local/bin/
sreda --install-desktop          # ярлык в меню приложений (открывает своё окно)

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-web из архива для Linux:

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

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

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

  • Alt+F12 — терминал, Ctrl+Shift+T — новая вкладка, Alt+A — терминал с агентом (claude, codex, gemini, aider — список в настройках).
  • Если на машине есть tmux, каждая вкладка — сессия tmux: связь оборвалась или sreda закрыт — агент продолжает работать, вкладка вернётся сама, в том числе на другом устройстве.
  • Закрытие вкладки спрашивает: завершить сессию или оставить работать в фоне. Без sreda: tmux ls, tmux attach -t prodev-….

## 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 — правый клик по гаттеру.
  • Несколько репозиториев в одной папке — все видны сразу. Есть 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
 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 покажет, что доходит.

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

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                       # сообщать о новой версии

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

sreda раз в сутки спрашивает у этого сайта номер последней версии (и больше ничего не отправляет). Если вышла новая — в строке состояния появится «⬆ sreda X is out», в приложении и веб-версии — плашка «Download». Проверить сразу: F1 → «Check for Updates». Скачивание — как обычно, после входа на странице загрузок; Android-версия ставится поверх старой. Отключить: check = false в [updates].