Kolosal CLI
Консольный ИИ-помощник разработчика на основе Qwen Code: разбор и правка кода, автоматизация git, OpenAI-совместимые API, Hugging Face и изображения
- 464 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Консольный агент правит файлы проекта, выполняет команды и работает с git по вашим запросам
- Ключи OpenAI-совместимого сервиса и токен Hugging Face хранятся в окружении или `.env`, а запросы уходят во внешнюю модель
- Расход токенов трудно предсказать заранее
Установка
Ручная установка
npm install -g @kolosal-ai/kolosal-ai@latestНужен Node.js 20 или новее. Проверка: `kolosal --version`. Есть и скрипт `curl -fsSL https://raw.githubusercontent.com/KolosalAI/kolosal-cli/main/install.sh | bash`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Консольный агент правит файлы проекта, выполняет команды и работает с git по вашим запросам
- Ключи OpenAI-совместимого сервиса и токен Hugging Face хранятся в окружении или `.env`, а запросы уходят во внешнюю модель
- Расход токенов трудно предсказать заранее
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Kolosal CLI — консольный ИИ-помощник для разработчика, построенный на коде Qwen Code. Вы запускаете команду `kolosal` в папке проекта и ведете диалог: просите объяснить структуру кодовой базы, отрефакторить функцию, написать тесты для модуля или добавить обработку ошибок во все операции с базой данных. Помощник работает с большими кодовыми базами за пределами окна контекста обычных моделей. Модель подключается двумя способами. Через OpenAI-совместимый API задаются переменные `OPENAI_API_KEY`, `OPENAI_BASE_URL` и `OPENAI_MODEL`, через Hugging Face переменные `HF_TOKEN` и `HF_MODEL`. Если во входных данных есть изображение, Kolosal CLI сам переключается на модель с поддержкой зрения, режим настраивается параметром `vlmSwitchMode`. Лимит токенов на сессию задается в `.kolosal/settings.json`. Кроме разбора кода помощник автоматизирует рутину: разбирает коммиты за неделю по функциям, составляет список изменений, ищет и удаляет вызовы `console.log`, проверяет код на SQL-инъекции. Внутри сессии работают команды `/help`, `/clear`, `/compress` (сжимает историю, экономя токены), `/stats` и `/exit`. Ставится одной командой установки, через npm или готовым пакетом для macOS и Debian или Ubuntu; для Android есть сценарий Termux.
Для кого. Для разработчиков, которым нужен консольный агент в духе Qwen Code, работающий с любым OpenAI-совместимым API или моделями с Hugging Face.
Подходит, если
- Нужен консольный помощник, который подключается к своему OpenAI-совместимому серверу по адресу из `OPENAI_BASE_URL`
- Хочется подставить модель с Hugging Face через `HF_TOKEN` и `HF_MODEL`
- Надо быстро разобраться в чужой кодовой базе: структура, зависимости, эндпоинты и способы аутентификации
- Требуется составить журнал изменений по коммитам за последние семь дней
- В запросе есть скриншот, и помощник сам переключится на модель с поддержкой изображений
Не подходит, если
- Вы довольны Claude Code, Codex или Gemini CLI и не хотите менять привычный инструмент
- Нужен запуск моделей без внешних ключей: помощнику требуется ключ OpenAI-совместимого сервиса или токен Hugging Face
- Нужна установка через Homebrew: в README эта возможность помечена как скоро
- Вам нужен активно обновляемый проект: последний коммит в репозитории датирован декабрем 2025 года
Пример запроса к агенту
Объясни архитектуру этой кодовой базы и найди все эндпоинты API с их способами аутентификацииОграничения
Автор предупреждает, что Kolosal CLI может делать несколько обращений к API за один цикл, поэтому расход токенов бывает высоким, а оптимизацию он обещает в будущем. Для работы нужен ключ OpenAI-совместимого сервиса или токен Hugging Face, и из России API OpenAI недоступен. Установка Homebrew в README помечена как «скоро». Для npm нужен Node.js 20 или новее, для сборки из исходников клонирование и `npm run build`. Установщик запускается через `curl | bash`, а на Linux с `sudo`. Последний коммит в репозитории сделан в декабре 2025 года. Проект основан на Qwen Code, и лицензия Apache 2.0 с файлом NOTICE.
Как отключить. Удалите пакет: `npm uninstall -g @kolosal-ai/kolosal-ai`. Для пакетов .pkg и .deb используйте менеджер пакетов системы. Настройки лежат в `.kolosal/settings.json`, файл `.env` с ключами удалите вручную.
Частые вопросы
Как установить Kolosal CLI?
На macOS и Linux выполните `curl -fsSL https://raw.githubusercontent.com/KolosalAI/kolosal-cli/main/install.sh | bash`, на Linux при необходимости с `sudo`. Либо через npm: `npm install -g @kolosal-ai/kolosal-ai@latest` при Node.js 20 или новее. Проверьте установку командой `kolosal --version`.
Как подключить модель?
Через OpenAI-совместимый API задайте `OPENAI_API_KEY`, `OPENAI_BASE_URL` и `OPENAI_MODEL` в окружении или файле `.env`. Для Hugging Face задайте `HF_TOKEN` и `HF_MODEL`.
Как работает поддержка изображений?
Kolosal CLI замечает картинку во вводе и переключается на модель с поддержкой зрения. Режим задается параметром `experimental.vlmSwitchMode` со значениями once, session и persist, а `visionModelPreview` включает предварительную поддержку.
Как ограничить расход токенов?
В файле `.kolosal/settings.json` задайте `sessionTokenLimit`, например 32000. Команда `/compress` сжимает историю разговора, а `/stats` показывает данные текущей сессии.
Работает ли Kolosal CLI на телефоне?
В репозитории есть README-termux.md и скрипт install-termux.sh для Android. Подробности установки и возможные проблемы описаны в docs/INSTALLATION.md.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыКодинговый агент на Go для открытых моделей: из беседы делает задачи в отдельных ветках, сам проверяет и вливает результат, ведет все проекты в одном окне
Локальный кодинг-агент с терминальным интерфейсом: планирует, пишет несколько вариантов, проверяет их в песочнице и чинит, чтобы малые модели тянули код
Открытый агент для программирования в VS Code, JetBrains и терминале с выбором из сотен моделей
Агент OpenAI для программирования, который работает локально в терминале, с версиями для IDE и десктопа
Плагин-оркестратор для OpenCode и Codex CLI: несколько агентов, хуки, встроенные MCP, режим ultrawork и правки по хешам строк
Учебный терминальный агент для кода на Python, задуманный как «nanoGPT для агентов»: прочитать, разобрать и форкнуть
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Kolosal CLI (эта запись) | нет | 464 | |
| Qwen Code | нет | 28 798 | исходный проект Qwen Code, на котором построен Kolosal CLI, с собственной системой входа и настройками |
| Gemini CLI | нет | 108 601 | консольный агент Google для моделей Gemini; Kolosal CLI рассчитан на OpenAI-совместимые API и Hugging Face |
Коротко о README
README представляет Kolosal CLI как ИИ-инструмент рабочего процесса для разработчиков на базе моделей Qwen Code, перечисляет возможности и способы установки: быстрый скрипт, npm, ручная загрузка пакетов и сборка из исходников. Затем описаны запуск, два способа входа, настройка лимита токенов и режима зрения, примеры запросов по анализу кода, разработке и автоматизации. В конце даны команды сессии, сочетания клавиш и ссылки для участников проекта.