MiniCode CLI
MiniCode — компактный терминальный кодинг-агент на TypeScript в духе Claude Code: цикл с инструментами, интерфейс TUI, навыки, MCP и подагенты
- 1 150 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент пишет файлы и запускает команды в вашем проекте, хотя правки перед записью можно подтверждать
- Токен API хранится в файле ~/.mini-code/settings.json
- Подключенные MCP-серверы и веб-запросы расширяют доступ агента
Установка
Ручная установка
git clone https://github.com/LiuMengxuan04/MiniCode.git
cd MiniCode
npm install
npm run install-localУстановщик спросит модель, ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN. Запуск после установки: minicode.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент пишет файлы и запускает команды в вашем проекте, хотя правки перед записью можно подтверждать
- Токен API хранится в файле ~/.mini-code/settings.json
- Подключенные MCP-серверы и веб-запросы расширяют доступ агента
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MiniCode — небольшая реализация терминального кодинг-агента. Запрос проходит цикл «модель, инструмент, модель»: агент читает рабочую папку, вызывает инструменты для файлов, поиска, правки, команд и веб-запросов, затем отвечает в том же сеансе. Перед записью в файл показывается правка с проверкой путей и команд. В полноэкранном интерфейсе есть история ввода, прокрутка записи, меню слэш-команд и подтверждения. Команда /plan показывает список задач, /goal ведет цель через несколько ходов, /loop повторяет промпт с задержкой, а до трех подагентов только читают код, пока корневой агент сам вносит все правки. Сеансы сохраняются по проектам, их можно возобновить, переименовать, ответвить и сжать. Навыки находятся через SKILL.md, MCP подключается по stdio и удаленному HTTP. Установщик спрашивает модель, ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN и сохраняет настройки в ~/.mini-code. Автор прямо называет проект учебным: его удобно читать и менять. Версии на Rust, Python, Go и Java ведут отдельные авторы.
Для кого. Для разработчиков, которые хотят разобраться, как устроен агент в духе Claude Code, и собрать на его основе собственный инструмент.
Подходит, если
- Нужен небольшой исходник цикла «модель, инструмент, модель», чтобы изучить его и изменить под себя
- Вы хотите попробовать терминального агента с подагентами, /goal и /loop без большой платформы
- Агент должен работать через Anthropic-совместимый адрес, который вы задаете сами в ANTHROPIC_BASE_URL
- Требуется показать правку и подтвердить ее до записи в файл
- Нужно прогнать интерфейс без обращения к модели: для этого есть режим mock
Не подходит, если
- Нужен готовый продуктовый агент с поддержкой и частыми релизами: проект самого автора учебный
- Установка должна идти из менеджера пакетов: в репозитории только клонирование и npm run install-local
- Нужны провайдеры помимо Anthropic-совместимого API: установщик спрашивает такие адрес и токен
- Вы планируете держать несколько разных агентов на записи кода: подагенты MiniCode читают, пишет только корневой
Пример запроса к агенту
Запусти minicode, прочитай папку src и предложи правку функции разбора конфигурации, показав дифф до записиОграничения
- Установка только из клона репозитория: git clone, npm install и npm run install-local. Пакет в npm в описании не заявлен.
- Установщик просит модель, ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN, поэтому нужен доступ к Anthropic-совместимому API.
- Настройки и список MCP-серверов лежат в ~/.mini-code/settings.json и mcp.json, каталог меняет MINI_CODE_HOME.
- Версии на Rust, Python, Go и Java живут в отдельных репозиториях со своими авторами.
- Проект сам описывает себя как учебный и экспериментальный.
Как отключить. Удалите лаунчер minicode из папки, которую задает MINI_CODE_BIN_DIR, и каталог настроек ~/.mini-code. Клонированную папку репозитория можно удалить вручную.
Частые вопросы
Как установить MiniCode?
Склонируйте репозиторий, выполните npm install и npm run install-local. Установщик спросит имя модели, ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN и создаст лаунчер minicode.
Как запустить MiniCode без доступа к модели?
Режим mock запускается командой MINI_CODE_MODEL_MODE=mock npm run dev. Он нужен для проверки интерфейса и цикла инструментов, ответов модели в нем нет.
Что умеют подагенты MiniCode?
До трех подагентов работают одновременно и только читают код. Все изменения вносит корневой агент: он может подождать подагентов или закрыть их.
Чем MiniCode отличается от Claude Code?
MiniCode повторяет рабочий процесс и архитектурные идеи Claude Code в гораздо меньшем объеме кода, поэтому подходит для изучения и экспериментов. Продуктовой поддержки у него нет.
Как подключить MCP и навыки в MiniCode?
Навыки подхватываются из SKILL.md, посмотреть их можно командой /skills. MCP-серверы подключаются по stdio или удаленному HTTP, статус показывает /mcp, а список лежит в ~/.mini-code/mcp.json.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыТерминальный кодинг-агент на Python в манере Claude Code: читает репозиторий, правит файлы, запускает команды, с памятью, подагентами и MCP
Терминальный агент для кодинга, заточенный под модель deepseek-v4: глубокие рассуждения, управление усилием, Agent Skills и MCP
Открытый терминальный кодинг-агент на TypeScript, заточенный под модели DeepSeek и дешевое кеширование
MCP-сервер и CLI для исследования кода: поиск и разбор по вашему проекту и по всему GitHub с экономией токенов
Плагин и скилл, который заставляет агента писать минимум кода: сначала повторное использование, stdlib и нативные возможности
Локальный граф кода для агентов: MCP-сервер отдает точки входа, связи символов и радиус влияния изменений за один вызов
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
Коротко о README
Описание открывается заявлением, что это легкий терминальный помощник с процессом работы как у Claude Code. Затем идут блок спонсора, список основных авторов и версий на разных языках, причины выбрать проект и перечень возможностей: цикл с инструментами, подагенты, план, цель, повтор, интерфейс, сеансы, учет контекста, навыки и MCP. Далее приведены установка, запуск, режим mock, основные команды и ссылки на документацию.