backscroll — MCP-сервер для Claude Code: что делает и как установить
Записывает полный вывод консольных команд в локальную базу SQLite и помогает искать в нём текст, ошибки и разницу между запусками. Выручит, когда терминал очистился или окно закрылось.
Открыть на GitHubЧто делает backscroll
Привычная история оболочки помнит только введённые команды, но теряет их вывод. backscroll перехватывает поток через псевдотерминал (PTY), разделяя его по командам с помощью семантических меток OSC 133. Все записи сохраняются на диске в файле ~/.local/share/backscroll/backscroll.db. Никаких внешних серверов или телеметрии тут нет.
Внутри базы логи сжимаются через zstd. Полнотекстовый поиск построен на модуле SQLite FTS5 с триграммами, поэтому легко находить фрагменты ошибок или токены без точного совпадения регистра. Программы с альтернативным экраном вроде vim или htop исключаются из записи автоматически. Длинные логи обрезаются с сохранением начала и конца.
Запись не начнётся сама по себе: сессию нужно запускать через backscroll run либо настроить шелл через ~/.zshrc или ~/.bashrc. Если окно закрыть посреди долгого процесса, утилита успеет сбросить накопленный текст в базу перед выходом.
Какие задачи решает
- найти в выводе прошлых команд утерянный токен, ошибку или IP-адрес
- сравнить вывод двух запусков одной команды через
backscroll diff - восстановить консольный текст из закрытого окна терминала или tmux
- экспортировать команду и её результаты в markdown для баг-репорта
Примеры запросов агенту
- Найди в выводе прошлых команд ошибку permission denied и покажи строку с ней
- Сравни результаты последних двух запусков terraform plan через backscroll
- Покажи полный вывод предпоследней консольной команды
Как установить backscroll
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о backscroll
Как установить backscroll?
На Linux и macOS утилита устанавливается официальным скриптом: curl -fsSL https://raw.githubusercontent.com/soren-achebe/backscroll/main/install.sh | sh.
Что делает MCP-сервер backscroll?
Он открывает агенту доступ к локальной базе записанных терминальных сессий. С его помощью ИИ может искать логи по ключевым словам, извлекать полный вывод команд и сравнивать различия между повторными запусками.
Куда сохраняются данные терминала?
Вся история пишется локально в файл ~/.local/share/backscroll/backscroll.db. Программа не использует фоновые демоны и не передаёт данные в сеть.
