Agentica CLI
Открытый кодовый агент для терминала, браузера и десктопа, который работает с моделями от OpenAI и Claude до Ollama
- 359 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Агент пишет и правит файлы и выполняет команды оболочки, песочница включается флагом --sandbox
- Шлюз открывает веб-интерфейс и принимает указания из мессенджеров, поэтому его нужно защитить паролем и не публиковать порт
- Ключи провайдеров, сессии и память хранятся в ~/.agentica, часть контекста уходит выбранному поставщику модели
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/agenticaОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент пишет и правит файлы и выполняет команды оболочки, песочница включается флагом --sandbox
- Шлюз открывает веб-интерфейс и принимает указания из мессенджеров, поэтому его нужно защитить паролем и не публиковать порт
- Ключи провайдеров, сессии и память хранятся в ~/.agentica, часть контекста уходит выбранному поставщику модели
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Agentica — открытый агент для работы с кодом, который ставится командой uv tool install agentica и запускается словом agentica в терминале. Тот же агент доступен в браузере и в десктопном приложении, для них нужен пакет agentica[gateway]. Агент читает и правит файлы через read_file и apply_patch, ищет по коду, выполняет команды, ходит в сеть и смотрит картинки. Модель выбирается свободно, от OpenAI и Claude до DeepSeek и локальной Ollama, а переключает ее команда /model прямо в сессии. Агент запоминает проект. Предпочтения хранятся в AGENTS.md, факты о проекте в долговременной памяти, а найденные решения он оформляет в SKILL.md и использует в следующих похожих задачах. Для длинных диалогов большие выводы команд сохраняются в файл, старые результаты инструментов вычищаются, а при заполнении окна агент записывает цель и незавершенное в файл заметок и продолжает в новом окне. Команда /goal ведет долгую задачу, /worktree изолирует работу, /resume возвращает прошлую сессию. Несколько терминалов превращаются в команду: подзадача task читает код в режиме чтения, delegate запускает отдельный процесс, а peer-сообщения связывают две открытые сессии. Через шлюз агент отвечает из мессенджеров, от Telegram и Slack до WeChat и Feishu. Для Python есть SDK, а для Node клиент @agentica-ai/sdk.
Для кого. Для разработчиков, которым нужен кодовый агент не привязанный к одному поставщику моделей, и тем, кто хочет управлять сессиями за компьютером из мессенджера.
Подходит, если
- Вы хотите работать с DeepSeek, Qwen, Kimi или локальной Ollama так же, как с Claude Code или Codex
- Длинная задача часто упирается в контекст: нужны сохранение больших выводов в файл и перенос цели в новое окно
- На компьютере идет сессия, а вы ушли: через Telegram или Feishu командой @list видно, что еще работает, и можно отправить указание
- Нужны десктопное приложение и браузерный интерфейс с отдельными аккаунтами, у каждого свои сессии и память
- Python-проекту нужен встроенный агент с инструментами, памятью и MCP: пригодится SDK
Не подходит, если
- Нужен только Claude Code с его родными подписками: у Agentica другой набор инструментов и свои настройки
- Нельзя ставить неподписанный установщик: сборки десктопного приложения не подписаны, macOS и Windows показывают предупреждение при первом запуске
- Нет ключа ни одного провайдера и нет локальной модели: без них агент не работает
- В системе нет Python 3.10 или новее
Пример запроса к агенту
Разберись, почему падают юнит-тесты в этом репозитории, исправь и запиши в проектные правила, как запускать тестыОграничения
- Нужен ключ хотя бы одного поставщика моделей (OPENAI_API_KEY, ZAI_API_KEY и другие) или локальная модель. Порядок приоритета: переменные окружения, затем .env, затем config.yaml.
- Установщики для десктопа не подписаны. На macOS придется один раз выполнить sudo xattr -rd com.apple.quarantine /Applications/Agentica.app, на Windows нажать «Все равно запустить», на Linux сделать AppImage исполняемым.
- Основная документация написана на китайском, английская версия лежит в README_EN.md.
- Интеграции с WeChat, WeCom и Feishu рассчитаны на китайские мессенджеры, а Telegram и Slack тоже поддерживаются.
- Данные лежат в ~/.agentica: сессии, память и конфигурация.
Как отключить. Удалите CLI командой uv tool uninstall agentica. Если ставили шлюз, он тоже входит в этот пакет. Данные, память и сессии лежат в ~/.agentica, удалите папку, когда они больше не нужны. Десктопное приложение удаляется обычным способом вашей системы. Контейнер Docker останавливает docker compose down.
Частые вопросы
Как установить Agentica и запустить веб-версию?
Выполните uv tool install agentica для консоли. Для веб-версии и десктопа нужен uv tool install "agentica[gateway]", затем команда agentica-gateway. Страница открывается на http://127.0.0.1:8881/chat. При первом запуске создается аккаунт default, а его случайный пароль выводится в терминал.
Какие модели поддерживает Agentica?
OpenAI по Chat Completions и Responses API, DeepSeek, Claude, GLM от Zhipu, Qwen, Kimi, Doubao и Ollama. Модель переключается командой /model во время сессии. Можно задать несколько запасных моделей на случай ошибки.
Как ограничить Agentica в правах?
Запустите агента с флагом --sandbox: без него он пишет файлы и выполняет команды оболочки напрямую.
Как управлять Agentica из мессенджера?
Подключите шлюз к WeChat, WeCom, Feishu, Telegram, QQ, DingTalk или Slack по инструкции в документации Gateway. Сообщение @list покажет открытые сессии на компьютере, а @имя_сессии и текст отправляет указание в нужный терминал.
Как запустить Agentica в Docker?
Скопируйте .env.docker.example в .env, впишите OPENAI_API_KEY и выполните docker compose up -d --build. Интерфейс откроется на http://127.0.0.1:8881/chat, данные лежат в named volume, а текущая папка монтируется в контейнер как /workspace.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыУчебный терминальный агент для кода на Python, задуманный как «nanoGPT для агентов»: прочитать, разобрать и форкнуть
TUI поверх tmux ведет сессии Claude Code, Codex и других агентов одним списком: статус, быстрые промпты, worktree и ревью диффа
Открытый агент для программирования в терминале и на десктопе с режимами разработки и планирования
Многоагентная обвязка с проверкой результата по артефактам: стоп-хуки, независимый судья и журнал событий для Claude Code, Codex, Cursor и других
Локальный ИИ-агент, который работает на своем железе через llama.cpp, водит браузер, правит файлы, выполняет разрешенные команды и помнит контекст между сессиям
Самостоятельный агент-платформа для одного рабочего места: чат с планированием, база знаний, MCP-инструменты, скиллы, память и песочница
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Agentica (эта запись) | нет | 359 | |
| OpenCode | нет | 222 896 | терминальный агент на любых моделях, но без шлюза в мессенджеры и самонакопления скиллов |
| Hermes Agent | нет | 258 249 | самообучающийся агент с мессенджерами и cron-задачами |
| Cline | нет | 71 010 | агент для VS Code, JetBrains и терминала без мобильного шлюза |
Коротко о README
Главная страница на китайском начинается с пяти причин выбрать проект и сравнения с Codex на открытых задачах. Для механизмов task, delegate и peer есть отдельная таблица, а в конце идет журнал версий.