Suvadu — MCP-сервер для Claude Code: история команд и сессий агентов
Заменяет историю шелла хранилищем на SQLite: каждая команда получает код возврата, длительность, каталог и сессию. Агенты читают это через MCP.
Открыть на GitHubЧто делает Suvadu
Suvadu перехватывает команды через хук шелла и пишет их в локальную базу SQLite. У записи есть структура: код возврата, время выполнения, каталог, исполнитель, сессия. Внутри git-репозитория добавляется ветка, на которой команда была набрана. Всё хранится на машине, без облака и телеметрии.
MCP-сервер отдаёт агенту 22 инструмента только для чтения, 8 ресурсов и 6 промптов. Две пишущие операции выключены, пока их не включат вручную. Через них агент ищет по истории, разбирает прошлые падения, оценивает риск команды и связывает команду с промптом, который её вызвал. Настройки живут в suv settings.
Ставится через Homebrew, установочный скрипт или Cargo. Для Cargo нужен Rust 1.95 или новее. После установки в ~/.zshrc или ~/.bashrc добавляется строка eval "$(suv init zsh)", иначе команды не записываются. Стрелку вверх перехватывают плагины вроде oh-my-zsh, zsh-history-substring-search, zsh-vi-mode, fzf, atuin и mcfly — строку с eval придётся поставить последней в ~/.zshrc. В Bash стрелка вверх пока не работает, там только Ctrl+R.
Какие задачи решает
- найти команду, которая упала вчера в другом каталоге
- понять, какой промпт породил конкретную команду агента
- оценить риск команды до запуска
- собрать историю сессий Claude и Codex в одном месте
- вернуть недавнюю команду по началу строки
Примеры запросов агенту
- Найди в истории команды, которые завершились с ошибкой в этом проекте
- Покажи, какой промпт вызвал последнюю команду сборки
- Оцени риск команды
rm -rf buildпо прошлым запускам
Как установить Suvadu
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Suvadu
Как установить Suvadu в Claude Code?
Сначала поставьте сам бинарник: brew tap AppachiTech/suvadu && brew install suvadu. Затем добавьте хук шелла — echo 'eval "$(suv init zsh)"' >> ~/.zshrc && source ~/.zshrc для zsh или ту же строку с bash и ~/.bashrc для Bash. Проверьте через suv status.
Что делает Suvadu?
Хранит историю команд в SQLite вместе с кодом возврата, длительностью, каталогом и сессией. Агент читает эти данные через MCP: ищет команды, разбирает падения, оценивает риск.
Почему стрелка вверх перестала работать после установки?
Её перехватил плагин, загруженный после строки eval "$(suv init zsh)". Поставьте эту строку последней в ~/.zshrc и выполните exec zsh. Команда suv doctor покажет, какой виджет занял стрелку.
