CoreCoder CLI
Учебный терминальный агент для кода на Python, задуманный как «nanoGPT для агентов»: прочитать, разобрать и форкнуть
- 1 864 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент пишет и правит файлы и выполняет команды оболочки, причем решение «всегда разрешать» сохраняется между запусками
- Флаг `--yes` в режиме `-p` разрешает все изменяющие вызовы заранее, а хуки запускают ваши команды вокруг каждого вызова
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/corecoderОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент пишет и правит файлы и выполняет команды оболочки, причем решение «всегда разрешать» сохраняется между запусками
- Флаг `--yes` в режиме `-p` разрешает все изменяющие вызовы заранее, а хуки запускают ваши команды вокруг каждого вызова
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
CoreCoder — компактный терминальный агент для кода в духе Claude Code, написанный на Python. Автор задумал его как «nanoGPT для агентов»: движок чуть больше тысячи строк, который можно прочитать за вечер, поставить точку останова на любой строке и переписать под себя. Вместе с кодом идет серия из восьми двуязычных очерков, которые разбирают устройство цикла, инструментов, контекста и подагентов по самому коду. Агент читает и пишет файлы, запускает команды оболочки, ищет по проекту, ведет список задач и запускает подагентов. Всего восемь инструментов: bash, read_file, write_file, edit_file, glob, grep, todo_write и agent. Правка файла заменяет единственное совпадающее место, номера строк не используются. Контекст сжимается тремя ступенями: сначала обрезаются длинные выводы, затем старые реплики сводятся в пересказ, в крайнем случае включается аварийное сжатие. Модель задают переменными окружения: подойдут DeepSeek, локальная Ollama и другие OpenAI-совместимые провайдеры, для остальных есть необязательный бэкенд LiteLLM. В режиме REPL есть команды `/plan`, `/undo`, `/diff`, `/tokens`, хуки вокруг вызовов инструментов и подключение MCP-серверов.
Для кого. Для разработчиков, которые хотят понять, как устроен агент для кода вроде Claude Code, и для тех, кому нужна небольшая основа, чтобы собрать собственного агента.
Подходит, если
- Хотите разобрать устройство агента по настоящему коду и серии очерков
- Нужна основа для форка: добавить свой инструмент на 32 строках базового класса, поменять системный промпт или модель
- Нужен простой агент в терминале с моделью DeepSeek, Qwen, Kimi или локальной Ollama через один адрес API
- Хотите встроить агента в свою программу как библиотеку: Agent, LLM и Config экспортируются из пакета
Не подходит, если
- Нужен повседневный инструмент для большой команды: проект учебный и не задуман как замена Claude Code
- Работаете с недоверенным вводом: у агента нет песочницы
- Нужны поиск по большому репозиторию с RAG или жесткий лимит бюджета: этого в проекте нет
- Нужны ресурсы и промпты MCP: клиент в mcp.py поддерживает только инструменты
Пример запроса к агенту
Запусти corecoder в режиме /plan, найди все TODO в проекте, предложи план правок, а после моего «approve» исправь первые триОграничения
- Нужен Python 3.10 или новее и ключ провайдера модели. API OpenAI и Anthropic из России недоступны, поэтому провайдера проверьте до установки.
- Опасные команды в bash блокирует простой список регулярных выражений. Он страхует от ошибок и не заменяет изоляцию.
- Повторы запросов к модели идут только с нарастающей паузой, запасной модели и жесткого лимита расходов нет.
- Подагенты работают синхронно, поиска по большим репозиториям через RAG нет.
- Лицензия MIT.
Как отключить. Удалите пакет командой `pip uninstall corecoder`. Сессии, права, настройки и список MCP-серверов лежат в ~/.corecoder: удалите папку, если они больше не нужны.
Частые вопросы
Как установить CoreCoder и запустить его с DeepSeek?
Выполните `pip install corecoder`, затем задайте OPENAI_API_KEY, `OPENAI_BASE_URL=https://api.deepseek.com` и `CORECODER_MODEL=deepseek-chat`. Команда corecoder откроет интерактивный режим, а `corecoder -p "задача"` выполнит одну задачу и завершится.
Чем CoreCoder отличается от Claude Code и aider?
Claude Code закрытый и большой, aider занимает десятки тысяч строк на Python. CoreCoder оставляет только минимальное ядро, которое читается за вечер, и предназначен для изучения и форка.
Как CoreCoder защищает файлы и команды?
Чтение и поиск выполняются сразу. Запись, правка, bash и запуск подагента сначала спрашивают согласие: разово, всегда для инструмента или отказ. Решение «всегда» хранится в ~/.corecoder/permissions.json.
Можно ли подключить MCP-серверы к CoreCoder?
Да. Положите mcp.json в ~/.corecoder в том же формате, что у Claude Code, и инструменты сервера появятся как mcp__<сервер>__<инструмент>. Каждый вызов проходит через запрос согласия.
Что делает режим /plan в CoreCoder?
Пока он включен, любые изменяющие вызовы отклоняются, а агент изучает проект на чтение и предлагает пронумерованный план. После слова approve или повторного `/plan` управление возвращается и агент выполняет правки.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыОткрытый личный AI-ассистент на своем компьютере: отвечает в Telegram, Slack, Discord и WhatsApp, расширяется скиллами и плагинами
Система для кодовых агентов: 68 агентов, 292 скилла, хуки, память, правила и сканер безопасности AgentShield
DeepSeek Harness — открытый ИИ-агент от DeepSeek, в котором все функции устроены как плагины. Работает в браузере, на macOS и Windows.
Самообучающийся агент от Nous Research: терминал, мессенджеры, cron-задачи и скиллы, которые он пишет сам
Открытый агент для программирования в терминале и на десктопе с режимами разработки и планирования
Ollama запускает открытые нейросети на вашем компьютере и отдает их агентам через локальный API, совместимый с OpenAI и Anthropic.
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
Коротко о README
Документация построена как путь «прочитать, потом форкнуть»: запуск за пять минут, карта кода по файлам с числом строк, разбор главного цикла и идеи для форка.