SmallCode CLI
SmallCode, кодинг-агент для локальных моделей 8B–35B: экономит контекст, делит работу на шаги и правит файлы патчами.
- 2 023 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент правит файлы и запускает команды в проекте; при включенной эскалации фрагменты кода уходят облачному поставщику.
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/smallcodeОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент правит файлы и запускает команды в проекте; при включенной эскалации фрагменты кода уходят облачному поставщику.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
SmallCode запускается в каталоге проекта как терминальный интерфейс и работает с локальной моделью через любой OpenAI-совместимый адрес: LM Studio, Ollama, llama.cpp. Контекст ведется с бюджетом и сжатием, вызовы инструментов разбирает терпимый к ошибкам парсер, а план хранится в TODO-файле и выполняется по шагам. Правки идут поиском и заменой фрагмента, а не перезаписью файла целиком. В комплекте 18 инструментов, граф кода, память сессий и необязательный индекс GitHub-репозиториев для поиска примеров. Модель и адрес задают в `.env` или `smallcode.toml`.
Для кого. Разработчики, которые гоняют кодинг-агента на своем железе и хотят, чтобы код не уходил в облако.
Подходит, если
- Код закрытый, и запросы к облачным моделям запрещены.
- На ноутбуке стоит модель Qwen на 8B, и обычный агент теряется на втором шаге.
- Задачу на несколько файлов разбивают на шаги в TODO-файле.
- Нужен терминальный агент, который при неудаче переключается на сильную модель по ключу.
Не подходит, если
- Используется модель крупнее 35B или облачная: авторы советуют инструменты под сильные модели.
- Модель на 4B и меньше: авторы отмечают потерю контекста между ходами.
- Нужна интеграция с плагином IDE, а не терминал.
Пример запроса к агенту
Разбери ошибку в тестах модуля оплаты, составь план в TODO-файле и исправь код патчами, запуская тесты после каждого шага.Ограничения
Автор рекомендует модели на 8B–35B; слабее справляются с цепочками инструментов. Нужен Node.js версии 18 или новее, а для индекса еще Python 3 и Git. `better-sqlite3` собирается нативно, без него память хранится в JSON. Включенный переход на облако отправляет фрагменты кода выбранному поставщику, поэтому для закрытого кода оставьте ключи облачных моделей пустыми и проверьте сетевые настройки. Последний коммит в августе 2026.
Как отключить. Удалите пакет командой `npm uninstall -g smallcode` и каталог `~/.smallcode`, если ставили готовые архивы. Файлы `.env`, `smallcode.toml` и `.smallcode/` в проекте удалите вручную.
Частые вопросы
Какие модели подходят?
Локальные на 8B–35B через любой OpenAI-совместимый адрес. Авторы оговаривают, что модели на 4B и меньше теряют контекст.
Как запустить без установки?
Командой `npx smallcode` в каталоге проекта. Есть и готовые архивы для Windows, macOS и Linux с встроенным Node.js.
Уходит ли код в облако?
Только если включена эскалация. По умолчанию все идет на локальный сервер, а ключи Anthropic, OpenAI, OpenRouter или DeepSeek включают переход на облако при тяжелом сбое.
Что делать при проблемах с экраном?
Запустить `smallcode --classic`: это интерфейс на readline вместо полноэкранного. Если терминал остался в сыром режиме, выполните `reset`.
Как построить индекс примеров?
Командой `npm run rag:index` из каталога репозитория или `smallcode-rag-index --preset broad` после установки. Нужны Python 3 и Git.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыКодинг-агент, настроенный под маленькие локальные модели: минимальный системный промпт, режим планирования и фоновые суб-агенты для исследования
Локальный кодинг-агент с терминальным интерфейсом: планирует, пишет несколько вариантов, проверяет их в песочнице и чинит, чтобы малые модели тянули код
Учебный терминальный агент для кода на Python, задуманный как «nanoGPT для агентов»: прочитать, разобрать и форкнуть
Самостоятельный ИИ-агент для кода с веб-интерфейсом: карта проекта, память решений, локальные модели через Ollama, права
MCP-сервер отдает ограниченные задачи локальной модели или дешевому облачному API, Claude остается архитектором
Кодинг-агент в терминале на одном бинарнике Rust: читает код, правит файлы, гоняет тесты и работает с любой моделью по выбору.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| SmallCode (эта карточка) | нет | 2 023 | |
| OpenCode | нет | 226 389 | рассчитан на сильные облачные модели; SmallCode адаптирован под локальные модели на 8B–35B |
| Aider | нет | 50 089 | работает в основном с git-коммитами и крупными моделями; SmallCode экономит контекст и ведет план в TODO-файле |
Коротко о README
README сравнивает SmallCode с агентами для сильных моделей по контексту, вызовам инструментов, планированию и приватности. Дальше идут установка, настройка моделей по уровням, архитектура и индекс GitHub-примеров.