Первые шаги
- Установка. Скачай
Hangar-Setup.exeи запусти его. Hangar устанавливается только для твоего пользователя, без прав администратора. - Запусти агента. Выбери папку проекта в разделе «Новый сеанс», выбери «Личная» или «Команда» и нажми на агента. Hangar показывает каждого агента, которого находит на твоём компьютере, вместе с его версией; в режиме «Команда» только тех, кто может работать как командный сеанс.
- Подключи команду (по желанию). Нажми «Войти» внизу боковой панели, подтверди код в браузере, затем подключи проект. Коллеги, которые присоединились к тому же проекту, видят друг друга в окне «Команда».
- Фотография профиля (по желанию). Твоя фотография из аккаунта Hangar отображается на боковой панели. Загрузить её можно на этом сайте в разделе Аккаунт › Настройки.
Скачать Hangar Поддерживаемые агенты
Если при установке Windows показывает предупреждение SmartScreen, выбери «Подробнее», а затем «Выполнить в любом случае». Установщик пока не подписан сертификатом подписи кода. Обновления внутри Hangar всегда подписаны и проверяются.
Требования: Windows 10 версии 1809 или новее либо Windows 11 (x64). Агентов ты устанавливаешь сам, со своими учётными записями. Git нужен для командных сеансов (worktree), отслеживания изменений, коммитов и общих заметок.
Сочетания клавиш
Hangar перехватывает только те сочетания, которые не нужны оболочкам и агентам. Варианты без Shift остаются за программой в терминале: Ctrl+B, Ctrl+F или Ctrl+P по-прежнему доходят до твоей оболочки или агента.
| Клавиши | Действие |
|---|---|
| Ctrl+Shift+P | Быстрый доступ: поиск сеансов, программ, файлов, последних коммитов, настроек и каждой команды меню |
| Ctrl+Shift+S | Поиск по выводу всех сеансов |
| Ctrl+Shift+M | Показать все сеансы живыми плитками |
| Ctrl+Shift+H | Показать стартовый экран; сеансы продолжают работать |
| Ctrl+Shift+T | Новый сеанс с последней использованной программой |
| Ctrl+Shift+W | Закрыть сеанс |
| Ctrl+Tab | Следующий сеанс |
| Ctrl+Shift+Tab | Предыдущий сеанс |
| Ctrl+Shift+A | Перейти к следующему сеансу, который ждёт тебя |
| Ctrl+Shift+N | Быстрая заметка |
| Ctrl+Shift+D | Показать или скрыть изменения в папке сеанса |
| Ctrl+Shift+F | Поиск по истории терминала |
| Ctrl+Shift+B | Свернуть или развернуть боковую панель |
| Ctrl+, | Открыть настройки |
| Ctrl++ | Крупнее текст |
| Ctrl+- | Мельче текст |
| Ctrl+0 | Сбросить размер текста |
| Клавиши | Действие |
|---|---|
| Ctrl+C | Копировать выделение; без выделения клавиша уходит в программу (прерывание) |
| Ctrl+Shift+C | Копировать выделение и оставить его выделенным |
| Ctrl+V | Вставить; если в буфере обмена изображение, Hangar вставляет путь к сохранённому файлу изображения |
| Shift+Enter | Новая строка в промпте агента, без отправки |
| Ctrl+Shift+Пробел | Удерживай для диктовки; речь распознаётся на твоём собственном компьютере |
| Клавиши | Действие |
|---|---|
| Enter | Следующее совпадение |
| Shift+Enter | Предыдущее совпадение |
| Esc | Закрыть поиск |
| Клавиши | Действие |
|---|---|
| F6 / Shift+F6 | При открытых заметках перемещать фокус между терминалом, списком заметок и редактором |
| F2 | Переименовать заметку |
| Alt+↑ / Alt+↓ | Переместить выбранный сеанс вверх или вниз в боковой панели |
| Ctrl+Enter | Отправить сообщение в несколько сеансов |
Профили в profiles.toml
Твои собственные терминалы и агенты описаны в profiles.toml в папке конфигурации, в Windows это %APPDATA%\com.feoren.hangar\profiles.toml. Если файла нет, Hangar при запуске создаёт его из шаблона с комментариями, с PowerShell 7, Windows PowerShell и командной строкой.
Быстрее всего открыть файл в настройках: Терминалы и агенты › Открыть файл профилей.
Агентам из каталога профиль не нужен, Hangar знает их сам. Чтобы запускать одного из них иначе, создай профиль с тем же id: он заменяет имя, значок, команду, аргументы и позицию записи каталога; страница проекта и команда установки остаются из каталога.
| Поле | Значение |
|---|---|
id | Обязательно. Уникальный, без пробелов. Hangar отклоняет два ID, которые различаются только регистром букв. |
name | Обязательно. Отображаемое имя в боковой панели. |
command | Обязательно. Имя программы из PATH или полный путь. Без синтаксиса оболочки: Hangar запускает программу напрямую. |
args | Аргументы списком, например ["--model", "opus"]. |
cwd | Фиксированная рабочая папка. Без этого поля программа запускается в папке, которую ты выбираешь. |
icon | Один или два символа для значка в боковой панели. |
[profile.env] | Переменные окружения отдельной таблицей. Не храни здесь секреты. |
secret_env | Имена переменных, значения которых Hangar хранит в диспетчере учетных данных Windows, например ["GITHUB_TOKEN"]. |
resume_args | Аргументы для продолжения последнего разговора. Они заменяют args, а не добавляются к ним. |
version_args | Аргументы для запроса версии, по умолчанию ["--version"]; [] означает: никогда не запускать программу ради чтения её версии. |
latest, packages, self_update, update_hint | Где публикуются новые версии и как Hangar обновляет программу одним щелчком. Шаблон с комментариями в файле объясняет каждое поле. |
Пример
Первый профиль запускает Claude Code из каталога с другой моделью. Второй это твой собственный PowerShell с фиксированной рабочей папкой, одной обычной и одной секретной переменной.
[[profile]]
id = "claude"
name = "Claude Code (Opus)"
command = "claude"
args = ["--model", "opus"]
icon = "C"
[[profile]]
id = "pwsh-shop"
name = "PowerShell (Shop)"
command = "pwsh"
args = ["-NoLogo"]
cwd = 'C:\src\shop'
icon = "SH"
secret_env = ["GITHUB_TOKEN"]
[profile.env]
DOTNET_CLI_TELEMETRY_OPTOUT = "1"
Секретные переменные
Значения из secret_env никогда не попадают в файл. Ты вводишь их в настройках, там же, где редактируешь профиль. Hangar хранит их в диспетчере учетных данных Windows под службой hangar и передаёт в окружение сеанса только при его запуске. Переменная не может одновременно стоять в [profile.env] и в secret_env.
После сохранения Hangar перечитывает файл, как только ты возвращаешься в его окно, либо ты выбираешь «Перечитать профили». Hangar показывает ошибку со строкой и столбцом; запущенные сеансы остаются как есть.
Уведомления об ожидающих агентах
Боковая панель с первого взгляда показывает, какой агент работает, какой готов и какой ждёт тебя. Всё остальное находится в настройках в разделе «Оповещения».
- Выделять ожидающие сеансы: сеанс мягко пульсирует, когда агент закончил или ждёт тебя, пока ты смотришь в другое место. Ты выбираешь, через сколько секунд тишины появляется подсказка.
- Цвета и пульсация: «Работает», «Готово», «Спрашивает» и «Пауза» получают каждый свой цвет, силу и длительность пульсации, с предпросмотром.
- Воспроизводить звук: мягкий двухтональный сигнал, когда ждёт сеанс, который ты сейчас не видишь. Если программа завершилась с ошибкой, звук ниже. Громкость настраивается.
- Показывать уведомление, когда сессия ждёт: только пока Hangar в фоне. Нажми на уведомление, чтобы открыть сеанс.
- Мигать на панели задач, когда сеанс ждёт: только пока Hangar не на переднем плане. Мигание прекращается, как только ты переходишь в его окно.
- Счётчик на панели задач: маленький значок на кнопке панели задач показывает, сколько сеансов ждёт, от 1 до 9 и 9+ выше этого.
- Push на телефон: через ntfy или Pushover, когда сеанс ждёт тебя. Для ntfy выбери тему, которую трудно угадать, потому что любой, кто её знает, может читать.
- Часы тишины: в выбранные тобой часы нет ни звука, ни уведомления, ни push на телефон, ни мигания на панели задач. Цвета и число ожидающих сеансов остаются.
- Продолжать работу в области уведомлений после закрытия окна: когда ты закрываешь окно, сеансы продолжают работать, а значок в области уведомлений показывает, сколько из них ждёт. Чтобы выйти из Hangar, щёлкни значок правой кнопкой.
Ctrl+Shift+A сразу переводит тебя к следующему ожидающему сеансу.
Командные сеансы и worktree
В разделе «Новый сеанс» ты выбираешь «Личная» или «Команда». Личный сеанс работает прямо в твоей папке, только для тебя. Командный сеанс получает собственный Git worktree и виден твоей команде, так что несколько агентов могут одновременно менять один проект и не выдёргивать файлы друг у друга из-под рук.
Для каждого командного сеанса Hangar создаёт ветку hangar/… от текущего состояния. Когда агент хочет править файл, над которым работает другой сеанс, Hangar останавливает его и спрашивает тебя; ответь «всегда» или «никогда» для файла или папки, и Hangar запомнит это для проекта. Claude Code, Codex CLI, OpenCode и Pi работают как командные сеансы.
Worktree лежат в папке данных приложения в %LOCALAPPDATA%\com.feoren.hangar\worktrees\, а не рядом с твоим репозиторием. Так репозитории и синхронизируемые папки остаются чистыми.
Когда агент запускается в свежем worktree, он сначала проверяет, нет ли новых коммитов в upstream, и спрашивает, прежде чем их забрать. Это можно отключить в настройках, в разделе «Терминалы и агенты».
Когда командный сеанс завершается, Hangar снова удаляет его worktree, если в нём нет изменений или игнорируемых файлов, например результатов сборки, и в нём не работает другой сеанс. Если в ветке есть ещё не слитые коммиты, она остаётся. Hangar никогда ничего не делает принудительно.
Git должен быть установлен, а папка должна находиться внутри репозитория Git. Hangar не запускает Git на сетевых ресурсах, а проверка перед правками не работает внутри WSL.
Заметки
Заметки относятся к проекту сеанса или к разделу «Общие». Это настоящие файлы Markdown, которые можно открыть и в Проводнике.
- Ctrl+Shift+N начинает быструю заметку откуда угодно.
- Отправляй выделенный текст терминала прямо в заметку или заметку в сеанс. Там она вставляется без Enter, чтобы ты сначала мог её проверить.
- Удалённые заметки попадают в «Недавно удалённые», откуда их можно восстановить.
- Вверху панели заметок ты переключаешься между «Личные» и «Общие», так твои заметки остаются отдельно от заметок команды.
Общие зашифрованные заметки
Когда ты включаешь общие заметки для проекта, Hangar шифрует их и хранит в папке .hangar\notes\ репозитория. Они переходят вместе с твоими коммитами. Прочитать их может любой, у кого есть репозиторий и код. Расшифрованный текст никогда не записывается на диск, и Hangar никогда не делает коммиты сам.
При включении Hangar один раз показывает код восстановления заметок. Сохрани его надёжно: без него заметки пропадут навсегда, если этот компьютер потеряет свой ключ. С этим кодом ты откроешь их и в другом клоне.
Один файл инструкций для всех агентов
HANGAR.md лежит в папке конфигурации рядом с profiles.toml и работает как AGENTS.md или CLAUDE.md, только без файла в твоём репозитории. Hangar передаёт его содержимое каждому агенту, который принимает дополнительные инструкции: Claude Code, Codex CLI и Aider. По умолчанию это включено; шаблон пуст и ничего не отправляет, пока ты не напишешь в нём что-нибудь.
Файл открывается в настройках, в разделе «Терминалы и агенты» › «Открыть HANGAR.md». Там же включается и выключается «Использовать HANGAR.md для каждого агента». Не записывай в него секреты: текст попадает в командную строку агентов.
Места хранения
Hangar хранит настройки в твоём профиле пользователя, в Windows в %APPDATA% и %LOCALAPPDATA%. Только общие заметки лежат в проекте.
| Расположение | Содержимое |
|---|---|
%APPDATA%\com.feoren.hangar\profiles.toml | Твои профили |
%APPDATA%\com.feoren.hangar\HANGAR.md | Твои инструкции для всех агентов |
%APPDATA%\com.feoren.hangar\account.json | Выбранный сервер и серверы, на которых ты вошёл; без токенов |
%LOCALAPPDATA%\com.feoren.hangar\workspace.json, scrollback\ | Открытые сеансы и их история, чтобы Hangar восстановил их после перезапуска |
%LOCALAPPDATA%\com.feoren.hangar\notes\ | Личные заметки в виде файлов .md, по папкам проектов и в general; удалённые в .trash |
%LOCALAPPDATA%\com.feoren.hangar\worktrees\ | Worktree твоих сеансов |
%LOCALAPPDATA%\com.feoren.hangar\pastes\ | Вставленные снимки экрана; Hangar удаляет их через неделю |
%LOCALAPPDATA%\Hangar | Сама программа |
.hangar\notes\ | Общие заметки, зашифрованные, в репозитории |
| Диспетчер учетных данных Windows | Секретные переменные профилей, твой вход и ключи для команды и общих заметок |
Свой сервер команды
Для команд Hangar по умолчанию подключается к официальному сервису по адресу https://hangar.feoren.com/api/v1. Без входа работает всё, кроме окна «Команда».
Если твоя команда держит собственный сервер Hangar, введи его адрес в настройках: Аккаунт › Адрес сервера (свой сервер), и нажми «Применить». Если оставить поле пустым, снова действует официальный сервис.
Адрес это базовый URL API сервера, например https://team.example.com/api/v1. Он должен начинаться с https://; простой http Hangar допускает только для localhost, 127.0.0.1 и [::1]. Имя пользователя, пароль, query и fragment не допускаются. Hangar сохраняет адрес в account.json; входы на другие серверы остаются сохранёнными на устройстве.
Такой сервер должен поддерживать тот же интерфейс, что и официальный сервис: вход через OAuth device flow, аккаунт и проекты, а также билеты для ретранслятора, который передаёт данные команды через WebSocket. Типы данных протокола и его шифрование открыты в репозитории приложения, в крейтах hangar-team-protocol и hangar-team-crypto под лицензией MIT.
Всё, чем ты делишься с командой, шифруется на твоём устройстве. Сервер хранит и пересылает данные, но не может их прочитать. Новые устройства присоединяются только после того, как кто-то сверит код безопасности и подтвердит его.
Текущее состояние: Готовое серверное ПО для собственного размещения ещё не опубликовано. Приложение уже умеет работать со своим адресом, но руководства по установке здесь пока нет.
Планируешь Hangar для компании и нужен собственный сервер? Напиши нам, и мы рассмотрим твой случай.