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

Hangar после установки

Всё, что нужно для повседневной работы с Hangar: от первого агента до файлов, в которых Hangar хранит твои настройки.

Первые шаги

  1. Установка. Скачай Hangar-Setup.exe и запусти его. Hangar устанавливается только для твоего пользователя, без прав администратора.
  2. Запусти агента. Выбери папку проекта в разделе «Новый сеанс», выбери «Личная» или «Команда» и нажми на агента. Hangar показывает каждого агента, которого находит на твоём компьютере, вместе с его версией; в режиме «Команда» только тех, кто может работать как командный сеанс.
  3. Подключи команду (по желанию). Нажми «Войти» внизу боковой панели, подтверди код в браузере, затем подключи проект. Коллеги, которые присоединились к тому же проекту, видят друг друга в окне «Команда».
  4. Фотография профиля (по желанию). Твоя фотография из аккаунта Hangar отображается на боковой панели. Загрузить её можно на этом сайте в разделе Аккаунт › Настройки.

Скачать Hangar Поддерживаемые агенты

Если при установке Windows показывает предупреждение SmartScreen, выбери «Подробнее», а затем «Выполнить в любом случае». Установщик пока не подписан сертификатом подписи кода. Обновления внутри Hangar всегда подписаны и проверяются.

Требования: Windows 10 версии 1809 или новее либо Windows 11 (x64). Агентов ты устанавливаешь сам, со своими учётными записями. Git нужен для командных сеансов (worktree), отслеживания изменений, коммитов и общих заметок.

Сочетания клавиш

Hangar перехватывает только те сочетания, которые не нужны оболочкам и агентам. Варианты без Shift остаются за программой в терминале: Ctrl+B, Ctrl+F или Ctrl+P по-прежнему доходят до твоей оболочки или агента.

В любом месте Hangar
КлавишиДействие
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 для компании и нужен собственный сервер? Напиши нам, и мы рассмотрим твой случай.

Контакт для команд