Перейти к содержанию

Кодинг-агенты

В Rysh каждая панель терминала работает как агент

6 мин чтения

Текст написан ИИ-моделью по источникам, на которые ведут ссылки, и сверен с ними второй моделью. Как мы работаем

Всё о теме: Агенты для программирования →
Изображение: github.com

Три панели одного стека дают в одном окне три независимые сессии Claude. Так работает Rysh, открытый мультиплексор терминала на Go, у которого каждая панель одновременно и агент: он принимает промпты и вызывает инструменты. Устройство проекта описано в README репозитория на GitHub от 17 августа.

Вкладки, сплиты, vim и htop ведут себя как обычно. Авторы всё равно советуют смотреть их пять роликов по порядку, начиная с первого, даже тем, кто годами работает в tmux или Zellij: панели выглядят знакомо, а модель сессии под ними устроена по-другому.

Сессия живёт отдельно от окна

Сессия в Rysh состоит из демона и его панелей. rysh create work создаёт сессию и сразу к ней подключается, с флагом -d она остаётся в фоне. rysh list-sessions показывает, что запущено, rysh attach work и rysh detach work подключают и отключают терминал, а rysh stop work останавливает демон. Закрытое окно сессию только отсоединяет, она работает дальше.

Во втором ролике это проверяют жёстче. Claude и Codex сообщают по кодовому слову, потом сессию останавливают целиком. После перезапуска оба агента сами, без нового промпта, продолжают разговор и называют те же слова.

Агент запускается командой внутри панели: ##claude открывает интерактивный Claude, ##codex открывает Codex. Rysh запоминает, какой агент работает в какой панели, поэтому после остановки и запуска поднимает тот же разговор. Можно сразу создать панель, где агент уже взял задачу: ##pane new --claude "start on the parser".

Внутри всё построено на акторах. Рабочее пространство, вкладка, панель и агент - отдельные акторы на proto.actor, которые обмениваются сообщениями через NATS. Эмуляцию терминала Rysh делает сам, на форке vt10x с прокруткой истории.

Вкладки, лейны и стеки

Раскладка вложенная. Вкладка содержит лейны (колонки), лейн содержит стеки, стек содержит панели. Как в Zellij, одна панель стека развёрнута, остальные свёрнуты до заголовка с меткой [N/M]. Сетку собирают одной командой: ##new grid 3x4 даёт три лейна по четыре панели в текущей вкладке, а ##new grid 2x3x4 открывает две вкладки по три лейна с четырьмя панелями в каждом. Готовые панели переносят между лейнами (##move pane <p> to-lane <lane>) и подписывают по назначению, например ##pane name builder.

У каждой панели есть режим ввода, двойной Esc переключает их по кругу. По умолчанию включены четыре: shell (настоящий PTY, псевдотерминал с обычной оболочкой), prompt (ввод уходит в LLM), rysh (команды самого мультиплексора) и chat (разговор без инструментов). ##mode list показывает режимы панели, ##mode new <mode> добавляет остальные. Команды с префиксом ## набираются в режиме rysh, а снаружи сессии то же делает rysh exec -- '##<cmd>' с выводом в терминал.

В третьем ролике стек делят агенты разных вендоров: между панелями переходят по Ctrl+S и цифре, у каждого агента своя задача, три файла пишутся параллельно.

Как агенты говорят друг с другом

Общаются агенты через доску. ##board open открывает её в отдельной панели, ##board post публикует веху, ##board reply отвечает в тред. Агент изнутри своей панели пишет на доску, не перехватывая фокус: rysh board post --as "$RYSH_PANE" -- 'parser wiring done', а читает командой rysh board tail --limit 20. ##board agent up запускает агента доски: скрытую панель с Claude, которая стоит на пути сообщений, пересылает их между агентами и отклоняет запрос, если знает, что он устарел. Его можно показать на экране без смены фокуса и снова спрятать, работать он при этом продолжает.

Флот - именованная группа панелей с собственной доской. Регистрация (##fleet register epic-07 --board epic-07) панелей не открывает, авторы называют её «дешёвой половиной». rysh board tail --fleet epic-07 показывает поток только этого флота, без остальной сессии. Во флоте могут быть только Claude, только Codex или те и другие, команды одинаковые.

В четвёртом ролике агент roadmap на Claude ставит цель, fleet-manager на Codex разбивает её на задания, два воркера строят параллельно, а менеджер возвращает одному из них правку и только потом закрывает работу. Результат - todo-менеджер в браузере без бэкенда и без шага сборки.

Пятый ролик, самый длинный из пяти (4:00), про проектирование флота. Оргструктура агентов в нём описана как граф: важно, какие рёбра есть и что изменится, если убрать одно. Приказы идут вниз сообщениями, результаты поднимаются на доску, а два воркера без ребра между ними выносят независимые вердикты.

Секреты подменяются до отправки

Механизм SecretNAT включён по умолчанию. Перед тем как запрос уйдёт с машины, секреты в его теле заменяются токенами, и модель видит только токен. Соответствие хранится локально и обратимо: ##snat get <token> возвращает настоящее значение прямо в вашей панели. Ответы при этом не переписываются, и авторы подчёркивают, что так задумано: если в ответе открытым текстом пришёл действующий ключ, Rysh только сообщит об этом в панель.

Две программы и Windows

Бинарников два, и они не взаимозаменяемы. rysh собирается из этого репозитория под лицензией Apache-2.0. ry - отдельный готовый дистрибутив со своими каналами установки и документацией, и ничего в нём из этого репозитория не собрано. Имена разные специально, чтобы обе программы могли стоять на одной машине, а скрипт или алиас под одну с другой не заработает. Какая стоит у вас, покажут rysh version или ry version.

На macOS и Linux открытую сборку ставят через go install github.com/rysh-ai/rysh-cli-code/cmd/rysh@latest, нужен Go 1.25.3 или новее. Есть и готовый бинарник через установочный скрипт с packages.rysh.ai: он берёт свежий релиз, а переменные RYSH_VERSION и RYSH_INSTALL_DIR фиксируют версию и папку установки. При первом запуске rysh onboard --provider anthropic --key-env ANTHROPIC_API_KEY проверяет ключ, создаёт в проекте rysh.config.yaml и открывает сессию, следом идёт rysh doctor.

С Windows сложнее. Цель windows/amd64 собирается без ошибок, а архив в .goreleaser.yml намеренно называется cli-only. Сессию открыть нельзя: в PTY-слое Rysh нет реализации ConPTY, псевдотерминала Windows, поэтому platform.PTYSupported равен false. Команда, которая открывает сессию, отказывает сразу и предлагает WSL, вместо того чтобы упасть на первой же панели. Команды без панелей работают, в том числе для связи с сессией в WSL со стороны Windows: rysh send, rysh exec, rysh prompt, rysh list-sessions, rysh doctor и другие. Поддерживаемый путь - WSL2, где сборка для Linux идёт без изменений.

Сам репозиторий - односторонний экспорт дерева, которое разрабатывают в другом месте: коммит, отправленный прямо сюда, затрёт следующий экспорт, а куда присылать патчи, объясняет CONTRIBUTING.md. Об уязвимостях авторы просят писать по закрытым каналам из SECURITY.md. Rysh выполняет shell-команды и хранит ключи провайдеров на машине разработчика, поэтому публичный отчёт, по их словам, становится «уведомлением об эксплойте».

Пока никто не написал. Будьте первым.

Присоединяйтесь к разговору

Войдите, чтобы оставить комментарий. Он появится после модерации.