Waveloom CLI

Терминальный кодинг-агент на Go для DeepSeek, Kimi, GLM и OpenAI с упором на кеш префикса и подтверждение каждой записи и команды

  • 138 ★ репозитория
  • Последний коммит
  • Apache-2.0
CLI

Широкий доступ

Почему такой уровень

  • Выполняет команды оболочки и пишет файлы, каждое действие идет через подтверждение, но настройки правил allow могут снять запрос
  • Хранит ключи API в `~/.waveloom/` и ходит в сеть через `web_fetch` и `web_search`
Все причины и проверки

menfre01/waveloom

Установка

Работает в

Ручная установка

curl -fsSL https://raw.githubusercontent.com/Menfre01/waveloom/main/install.sh | sh

macOS и 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`: агент помнит прежний контекст. Контрольные точки откатывают файлы к любому сообщению.

Обсуждение

Вопросов и отзывов пока нет.

Терминальный кодинг-агент в одном бинарнике Go для DeepSeek и других OpenAI-совместимых моделей, с графом кода и локальным OCR

CLIШирокий доступ391Звезды репозитория

Локальный кодинг-агент с выбором провайдера: DeepSeek, Kimi, OpenAI или Anthropic. Интерфейсы в терминале и браузере.

CLIШирокий доступ162Звезды репозитория

Терминальный кодинг-агент на Python в манере Claude Code: читает репозиторий, правит файлы, запускает команды, с памятью, подагентами и MCP

CLIШирокий доступ1 тыс.Звезды репозитория

Терминальный агент для кодинга, заточенный под модель deepseek-v4: глубокие рассуждения, управление усилием, Agent Skills и MCP

CLIШирокий доступ2,2 тыс.Звезды репозитория

Кодовый агент для терминала на Go: модели GLM, DeepSeek и локальный Ollama, 59 встроенных инструментов и MCP

CLIШирокий доступ110Звезды репозитория

Терминальный кодинг-агент на Python: цикл ReAct, файловый контекст, bash с ограничителями и скиллы, работает с DeepSeek и OpenAI

CLIШирокий доступ136Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйЗвезды репозиторияГлавное отличие
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.

Бейдж для README

Сообщить о проблеме