Waveloom CLI
Терминальный кодинг-агент на Go для DeepSeek, Kimi, GLM и OpenAI с упором на кеш префикса и подтверждение каждой записи и команды
- 138 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Выполняет команды оболочки и пишет файлы, каждое действие идет через подтверждение, но настройки правил allow могут снять запрос
- Хранит ключи API в `~/.waveloom/` и ходит в сеть через `web_fetch` и `web_search`
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/Menfre01/waveloom/main/install.sh | shmacOS и Linux, установка в `~/.local/bin` без sudo. Для Windows есть `install.ps1` и нужен Git for Windows.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Выполняет команды оболочки и пишет файлы, каждое действие идет через подтверждение, но настройки правил allow могут снять запрос
- Хранит ключи API в `~/.waveloom/` и ходит в сеть через `web_fetch` и `web_search`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Waveloom запускает кодинг-агента прямо в терминале. Архитектура держит самый длинный общий префикс запроса горячим в кеше DeepSeek между ходами, поэтому повторный ввод стоит заметно дешевле. Модель сама выбирает режим: `pro` для глубоких рассуждений и `flash` для рутины. Фиксированный системный промпт, история только с дописыванием и четырехуровневое сжатие по порогам сохраняют префикс неизменным. Встроено 14 инструментов: `read`, `write`, `edit`, `bash`, `web_fetch`, `web_search`, вызов скиллов и субагентов, режим плана и списки задач. Скиллы подключаются как в Claude Code: из каталогов `.claude/skills/` и `.claude/plugins/` читаются файлы `SKILL.md` с девятью полями заголовка. Есть полный MCP-клиент, хуки `PreToolUse`, `PostToolUse`, `Notification` и `Stop`, субагенты Evaluate, Explore и Verification, контрольные точки с откатом файлов и продолжение сеанса через `waveloom --continue`. Запись файлов и выполнение команд требуют вашего подтверждения. Решения о правах принимаются по правилам `allow`, `deny` или `ask`, а вывод инструментов проходит пять уровней проверки, в том числе поиск внедренных инструкций. Необязательная песочница работает на `bubblewrap` в Linux и Seatbelt в macOS.
Для кого. Разработчикам, которые гоняют длинные сеансы на DeepSeek и считают расходы на токены, но хотят привычные скиллы `.claude/skills` и полноценный терминальный интерфейс.
Подходит, если
- Длинная сессия на DeepSeek, и счет за непопавший в кеш ввод растет
- В проекте уже лежат скиллы Claude Code, и их хочется подключить к другой модели без переписывания
- Вы переключаете провайдеров DeepSeek, Kimi, GLM и OpenAI командой `/provider`
- Перед изменением кода нужен режим плана, в котором записывать можно только файл плана
- Скриншот или график надо разобрать мультимодальной моделью: `@shot.png`
Не подходит, если
- Вы работаете на Anthropic и нужен режим координатора: автор сам советует Claude Code
- Нужен рабочий стол с окнами и интеграцией с QQ-ботом: Waveloom только терминальный
- Среда Windows без Git Bash: нужен `bash.exe`, а `cmd` и PowerShell не поддерживаются
- Модель должна идти через сторонний релей: ключ уходит напрямую провайдеру
Пример запроса к агенту
Переключись на плановый режим, изучи модуль авторизации и предложи план рефакторинга, ничего не записывая кроме файла планаОграничения
- Нужен ключ API DeepSeek, Kimi, GLM или OpenAI: он хранится в `~/.waveloom/` и уходит напрямую провайдеру.
- На Windows нужен Git for Windows, работают только Git Bash и WSL2, а `cmd` и PowerShell не поддерживаются.
- Поиск в сети через провайдера `deepseek` оплачивается отдельно: 5 юаней за 1000 успешных вызовов.
- Автоматическая проверка правок после записи через LSP заявлена для Go, Rust, TypeScript, JavaScript и C/C++, на остальных языках идут сборочные команды вроде `go build`.
Как отключить. Удалите бинарник из `~/.local/bin` (при установке через Homebrew `brew uninstall waveloom`) и каталог `~/.waveloom/` с настройками и ключами.
Частые вопросы
Как установить Waveloom?
На macOS и Linux выполните `brew install menfre01/tap/waveloom` или скрипт `curl -fsSL https://raw.githubusercontent.com/Menfre01/waveloom/main/install.sh | sh`. Затем `waveloom setup` и `waveloom`.
Подхватывает ли Waveloom скиллы Claude Code?
Да, `SKILL.md` читается из `.claude/skills/`, а установленные плагины из `.claude/plugins/`. Поддержаны девять полей frontmatter, в том числе `$ARGUMENTS` и `paths`.
Как переключить модель или провайдера?
`/model` или `waveloom --model deepseek-flash` меняет модель, `/provider` или `/provider kimi` меняет провайдера. Профили лежат в `settings.json` в разделе `llm.profiles`.
Безопасен ли мой ключ API?
Ключ хранится локально в `~/.waveloom/` и идет напрямую в DeepSeek, Kimi, GLM или OpenAI без сторонних релеев.
Как вернуться к сеансу через несколько дней?
Запустите `waveloom --continue`: агент помнит прежний контекст. Контрольные точки откатывают файлы к любому сообщению.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыТерминальный кодинг-агент в одном бинарнике Go для DeepSeek и других OpenAI-совместимых моделей, с графом кода и локальным OCR
Локальный кодинг-агент с выбором провайдера: DeepSeek, Kimi, OpenAI или Anthropic. Интерфейсы в терминале и браузере.
Терминальный кодинг-агент на Python в манере Claude Code: читает репозиторий, правит файлы, запускает команды, с памятью, подагентами и MCP
Терминальный агент для кодинга, заточенный под модель deepseek-v4: глубокие рассуждения, управление усилием, Agent Skills и MCP
Кодовый агент для терминала на Go: модели GLM, DeepSeek и локальный Ollama, 59 встроенных инструментов и MCP
Терминальный кодинг-агент на Python: цикл ReAct, файловый контекст, bash с ограничителями и скиллы, работает с DeepSeek и OpenAI
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Waveloom (эта карточка) | нет | 138 | |
| Claude Code Harness | нет | 3 207 | оболочка вокруг Claude Code; Waveloom сам агент со своим циклом и кешем DeepSeek |
| DeepSeek Harness | да | 279 346 | другая оболочка для DeepSeek; здесь четырехуровневое сжатие и совместимость со скиллами Claude Code |
Коротко о README
Страница представляет Waveloom как терминального агента, рассчитанного на экономику кеша DeepSeek, и показывает демо. Затем идут установка для macOS, Linux и Windows, настройка, сравнительная таблица с Claude Code и Reasonix, особенности, ответы на вопросы и перечень документов по настройкам, кешу, MCP и подключению IDE.