Установка
Нужны Tabby и установленный, настроенный Codex или Claude Code. Для автоматического поиска сессий — Linux. Отдельный agent-sessions не требуется.
1. Установите плагин
- Откройте Tabby → Settings → Plugins.
- Найдите
agent-recoveryи нажмите Get / Install. - Перезапустите Tabby. В Installed должна появиться версия 1.1.0.
Если поиск не показывает пакет, откройте каталог кнопкой Plugins folder и выполните в нём:
npm install tabby-agent-recovery@latestЗатем перезапустите Tabby. Для обновления уже установленного плагина подходит та же команда. Пакет в npm.
Если используете разработческую копию через symlink, обновляйте её в исходной папке. Установка npm поверх ссылки заменит её пакетом из реестра.
2. Проверьте восстановление
- Включите восстановление вкладок в настройках Tabby.
- Откройте Codex или Claude Code в панели и начните разговор, чтобы агент сохранил его ID.
- Сделайте сплит и закройте Tabby обычным способом: при закрытии он сохраняет раскладку.
- Откройте Tabby снова. Проверьте прежний разговор, рабочую папку и расположение панелей.
После аварийного завершения доступна последняя сохранённая раскладка Tabby. Ещё не сохранённые изменения восстановить нельзя. Плагин возобновляет разговор, но не отправляет следующую реплику за вас.
Если автоматический поиск не сработал
Укажите точный ID нужного разговора в профиле Tabby. Это также способ использования на macOS и Windows. В Settings → Profiles создайте локальный профиль, задайте рабочую папку, исполняемый файл агента и аргументы:
# Codex: команда — путь к codex, аргументы:
resume <ID-разговора>
# Claude Code: команда — путь к claude, аргументы:
--resume <ID-разговора>Замените <ID-разговора> реальным UUID сессии. Аргументы вводятся отдельно от пути к исполняемому файлу. Команды --last и --continue не фиксируют конкретный разговор.
Общий демон Codex и нестандартные обёртки могут скрывать принадлежность сессии панели. Для новых сессий Codex с доступным параметром --no-daemonможно использовать его; уже существующий разговор надёжнее закрепить по ID.
Локальные файлы
По умолчанию снимки находятся в ~/.local/state/tabby-agent-recovery. Если уже есть состояние agent-sessions, используется его каталог. Путь можно задать через AGENT_SESSIONS_STATE.
TABBY_AGENT_RECOVERY_SCROLLBACK=1— включить историю экрана и полное окружение профиля в дополнительные снимки.TABBY_AGENT_RECOVERY_LOG=1— записывать вывод панелей в отдельные файлы.
Обе настройки по умолчанию выключены. Если они нужны, задайте переменные в окружении запуска Tabby, затем перезапустите приложение.