AACode CLI
Терминальный кодинг-агент на Python: цикл ReAct, файловый контекст, bash с ограничителями и скиллы, работает с DeepSeek и OpenAI
- 136 ★ репозитория
- Последний коммит
- GPL-3.0
Широкий доступ
Почему такой уровень
- Выполняет команды оболочки и пишет файлы в рабочей папке, защита ограничивается проверками команд и путей
- Передает код и контекст в API выбранной модели и хранит ее ключ в переменных окружения
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/aacodeОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Выполняет команды оболочки и пишет файлы в рабочей папке, защита ограничивается проверками команд и путей
- Передает код и контекст в API выбранной модели и хранит ее ключ в переменных окружения
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
AACode запускает кодинг-агента в терминале по схеме ReAct. Принципы автора: минимум каркаса и больше доверия модели, контекст хранится в файлах Markdown, bash служит универсальным адаптером с проверками команд и путей, управление контекстом заимствует приемы из Cursor и Manus, все блокирующие операции асинхронны. Инструменты делятся на атомарные, управляющие и скиллы, а ядро расширяется собственными инструментами и бэкендами моделей. Установка идет через `pip install aacode`, затем `aacode init` и просто `aacode` для интерактивной сессии. Одна задача запускается как `aacode "ваша задача"` в текущей папке, а `aacode run -p /путь "задача"` задает другую. Перед сложной работой можно создать `init.md` с подробным описанием, режимы `--plan-first` и `--interactive` дают планирование заранее и непрерывный разговор, а `--session` продолжает прежнюю сессию. Модель задается переменными `LLM_API_KEY`, `LLM_API_URL` и `LLM_MODEL_NAME`: подходят DeepSeek, OpenAI и совместимые провайдеры. Для тех, кому нужен интерфейс, есть настольный клиент для macOS и Windows и мобильные приложения для Android и iOS.
Для кого. Разработчикам на Python и DeepSeek, которым нужен компактный терминальный агент с понятным устройством, который можно читать и расширять.
Подходит, если
- Нужен небольшой агент для задач в одной папке, чей код можно прочитать целиком
- Вы хотите подключить DeepSeek или другого провайдера через три переменные окружения
- Сложную задачу надо начать с плана: `--plan-first`
- Сессию надо продолжить позже по идентификатору: `--session`
- Нужны свои инструменты и бэкенды модели в слоях инструментов агента
Не подходит, если
- Нужен зрелый агент с развитым интерфейсом и поддержкой: проект ориентирован на простоту
- Работа идет на Windows без настройки путей Python: основная разработка и тесты ведутся на Linux и macOS
- Требуется жесткая песочница: bash ограничивается проверками команд и путей, а изолированной среды в описании нет
- Нужны готовые скиллы под фронтенд или данные: набор содержит базовый слой
Пример запроса к агенту
aacode run -p ~/work/shop "Добавь тест для функции расчета скидки, запусти его и поправь код, если он падает" --plan-firstОграничения
- Нужен Python 3.10 и новее, автор рекомендует 3.12; разработка и проверка идут на Linux и macOS, на Windows возможны проблемы с путями Python.
- Нужен ключ и адрес API провайдера модели в переменных `LLM_API_KEY`, `LLM_API_URL` и `LLM_MODEL_NAME`; провайдера автор не настраивает заранее.
- Агент выполняет команды в вашей рабочей папке под защитой проверок команд и путей, но это не изолированная среда.
- Для настольного клиента по-прежнему нужны Python и зависимости, мобильным приложениям они не нужны.
Как отключить. `pip uninstall aacode` убирает программу. Файлы сессий и настройки остаются в каталоге проекта и в домашней папке, их удаляют вручную.
Частые вопросы
Как установить AACode?
Рекомендуется `pip install aacode`, затем `aacode init`. Вариант из исходников: `git clone https://github.com/kandada/aacode.git`, `python3 init.py` и `./run.sh -p examples/my_project "задача"`.
Как подключить модель?
Задайте `LLM_API_KEY`, `LLM_API_URL` и `LLM_MODEL_NAME`. Подходят DeepSeek, OpenAI и совместимые провайдеры, предварительной настройки провайдера нет.
Как запустить задачу в другой папке?
Выполните `aacode run -p /путь/к/проекту "задача"`. По умолчанию рабочая папка текущая.
Есть ли режим планирования?
Да, флаг `--plan-first` начинает со сложного плана, `--interactive` дает непрерывный разговор, `--session <id>` продолжает прежнюю сессию.
Есть ли графический интерфейс?
Да, настольный клиент AACode Desktop для macOS и Windows и мобильные приложения для Android и iOS. Настольному клиенту нужны Python и зависимости.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыТерминальный кодинг-агент на Python в манере Claude Code: читает репозиторий, правит файлы, запускает команды, с памятью, подагентами и MCP
Терминальный кодинг-агент в одном бинарнике Go для DeepSeek и других OpenAI-совместимых моделей, с графом кода и локальным OCR
Открытый терминальный кодинг-агент на TypeScript, заточенный под модели DeepSeek и дешевое кеширование
Терминальный агент для кодинга, заточенный под модель deepseek-v4: глубокие рассуждения, управление усилием, Agent Skills и MCP
Кодовый агент с ядром на Python и тремя интерфейсами: CLI для скриптов, TUI и приложение Electron, для моделей с API OpenAI
Кодинг-агент на Rust для терминала: параллельные агенты, цели, плагины в формате Claude Code и свой адрес API модели.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
Коротко о README
Страница подает AACode как легкого кодинг-агента на DeepSeek с архитектурой ReAct, перечисляет принципы проектирования и быстрый старт из исходников и через pip. Затем идут режимы запуска, настольный клиент, мобильные приложения, настройка модели и раздел о конфигурации.