CodeAgent CLI

Установка

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

git clone https://github.com/Harvil1/codeAgent.git
cd codeAgent
uv sync
uv run python main.py

Что делает

CodeAgent работает в терминале как ИИ-помощник для программирования. Вы пишете задачу обычным языком, агент читает код, правит файлы, запускает команды и ищет в сети, пока не закончит. Основной цикл собирает сообщения, сжимает контекст, обновляет набор инструментов и вызывает модель. Затем он раздает вызовы инструментов и заканчивает, когда модель инструментов больше не просит. Автор пишет, что реализовал все от интерфейса до основного цикла вручную и снабдил код подробными комментариями на китайском. Модель подключается по протоколу OpenAI или Anthropic, по умолчанию стоит DeepSeek. Рядом можно настроить вспомогательную дешевую модель для сжатия, поиска и выделения памяти. Опасные команды и запись файлов вне белого списка идут на панель согласования: разрешить один раз, разрешить всегда или отклонить. Внешние инструменты подключаются через `.mcp.json` проекта, при первом подключении требуется согласие. Память хранится в `MEMORY.md` и в журнале JSONL. Подагенты запускаются синхронно или в фоне, в изолированных worktree, есть командный режим с координатором, движок рабочих процессов с возобновлением, задания cron, хуки и откат сеанса командой `/rewind`. Конвейер самообучения наблюдает за диалогом и сохраняет повторяемые приемы как новые скиллы.

Для кого. Для разработчиков, которые хотят открытый терминальный агент в духе Claude Code с моделями DeepSeek, OpenAI, Anthropic или OpenRouter, и для тех, кто изучает устройство агента по подробно прокомментированному коду.

Пример запроса к агенту

Прочитай этот репозиторий, найди причину падения тестов, исправь ее и запусти тесты еще раз, а команды вне белого списка покажи мне на согласование

Ограничения

• Проект ведут и проверяют в первую очередь на Windows. Linux запускается с необязательной песочницей `bwrap`, а macOS по оценке автора теоретически работает и полностью не проверен. В `git-bash` (mintty) агент перезапускается через `winpty`.
• Ключ API читается из переменных `DEEPSEEK_API_KEY`, `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `OPENROUTER_API_KEY`, `ZHIPUAI_API_KEY` или из `models.<имя>.api_key` в `~/.codeAgent/settings.json`, где ключ лежит открытым текстом.
• Все данные хранятся в `~/.codeAgent/`: настройки, сеансы, память, скиллы, плагины и журналы, которые ротируются: до трех файлов по 5 МБ. Каталог меняется переменной `CODEAGENT_HOME`.
• Автор рекомендует перед правкой запускать `scripts/verify.py` с более чем 60 проверками и `ruff check`.

Как отключить. Закройте сеанс и удалите клонированную папку проекта. Чтобы стереть настройки, сеансы, память и журналы, удалите каталог `~/.codeAgent/` целиком, это полный сброс. Подключения MCP из `.mcp.json` проекта убираются правкой этого файла.

Коротко о README

В репозитории пакет `agent/` с десятками модулей (клиент модели, сжатие контекста, память, права, хуки, подагенты, движок рабочих процессов, защита от внедрения команд), встроенные определения подагентов `coordinator`, `explore`, `plan` и `verification`, скрипт проверки `scripts/verify.py`, файл `main.py` и описания на китайском и английском. Основная страница показывает возможности, быстрый старт, таблицу команд, расположение данных, обзор архитектуры и ответы на частые вопросы.