crow-cli
Кодинг-агент по протоколу ACP на Python: читает и правит код, держит все сессии в SQL и ищет по ним.
- 64 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент читает и правит файлы, запускает команды оболочки и ходит в сеть по ключу вашего поставщика моделей.
- Полные тексты всех сессий, включая вывод команд, хранятся в базе и доступны другим агентам.
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/crow-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент читает и правит файлы, запускает команды оболочки и ходит в сеть по ключу вашего поставщика моделей.
- Полные тексты всех сессий, включая вывод команд, хранятся в базе и доступны другим агентам.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
crow-cli — кодинг-агент с потоковым циклом ReAct, который читает и правит код, запускает команды оболочки, ищет в вебе и понимает картинки. Он работает по Agent Client Protocol: редактор или терминальный клиент запускает `crow-cli acp` и получает агента. Сессии хранятся в базе SQL, по умолчанию SQLite в `~/.agents/crow/crow.db`, а при необходимости PostgreSQL для нескольких машин. По всем сообщениям есть полнотекстовый поиск. Агенты читают прошлые разговоры друг друга и передают друг другу работу через эту базу, отдельного протокола между агентами нет. У сессий запоминаемые имена, которые можно возобновить или ответвить. Инструменты агент не несет в себе. Какие MCP-серверы клиент передает при создании сессии, такие инструменты у сессии и будут.
Для кого. Разработчикам, которым нужен собственный кодинг-агент с общей памятью сессий для нескольких машин и клиентов, от терминала до браузера.
Подходит, если
- Один агент должен прочитать разговор другого и продолжить его работу.
- Сессии надо искать полным текстом по всем прошлым разговорам.
- Одна база сессий нужна нескольким машинам, для этого есть PostgreSQL.
- Редактору с поддержкой ACP нужен кодинг-агент без привязки к одному поставщику моделей.
- Нужен вывод в JSONL по событиям для скриптов и разбора: `crow-cli run -j`.
Не подходит, если
- Нужна готовая облачная подписка без своего ключа: crow-cli работает с ключом совместимого с OpenAI поставщика.
- Docker недоступен: веб-поиск держится на сервисе SearXNG, который поднимается в Docker.
- Нужен Python старше 3.13: агент требует версию 3.13 или новее.
Пример запроса к агенту
crow-cli run "объясни, что делает этот репозиторий"Ограничения
Нужны Python 3.13 или новее с менеджером uv, Docker для SearXNG и ключ поставщика, совместимого с OpenAI, например OpenRouter. Клиенты, то есть терминал, IDE и браузер, лежат в отдельном репозитории `crow-cli/crow`, а сборка среды IDE работает пока только в Linux. Мастер `crow-cli init` пишет секреты в `~/.agents/crow/.env` и клонирует исходники, а в сессии агент получает только те инструменты, которые передал клиент. Скилл `crow-cli` ставится глобально в `~/.agents/skills/crow-cli`.
Как отключить. Выполните `uv tool uninstall crow-cli` и остановите контейнеры командой `docker compose down` в `~/.agents/crow`. Каталог `~/.agents/crow` с базой сессий и секретами удалите вручную.
Частые вопросы
Как установить crow-cli?
Выполните `uv tool install crow-cli --python 3.13`, затем `crow-cli init`: мастер спросит поставщика и модель и запишет конфигурацию в `~/.agents/crow`. После этого поднимите SearXNG командой `docker compose up -d` в той же папке.
Как запустить его из редактора?
Редактор или клиент с ACP запускает `crow-cli acp` по stdio. Для ACP v2 есть `crow-cli acp2`, а `crow-cli acp2 --http` держит один сервер для IDE, браузера и других клиентов на `ws://127.0.0.1:2771/acp`.
Где хранятся сессии?
В базе SQL: SQLite в `~/.agents/crow/crow.db` по умолчанию или PostgreSQL для общей базы. Картинки лежат файлами рядом и подмешиваются в запрос к модели только при отправке.
Откуда у агента инструменты?
От клиента. Агент сам инструментов не несет: клиент передает MCP-серверы при создании сессии. Собственные клиенты crow передают свой MCP-сервер, поэтому свежая установка работает сразу.
Как получить результат для скрипта?
Запустите `crow-cli run -j "задача" > run.jsonl`. На каждую строку приходится одно событие: сессия, мысли, сообщение, вызов инструмента, расход или ошибка. Флаг `-s <id>` продолжает сессию.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыacpx запускает кодовых агентов по протоколу ACP из командной строки: сессии в репозитории и одна форма команды для 30 агентов
CLI-агент работает с файлами и командами проекта, позволяет выбирать провайдера модели и подключать внешние MCP-инструменты.
Локальный кодинг-агент на Python: каждый шаг пишется в журнал, который можно разобрать, воспроизвести и продолжить.
Один рантайм для Claude Code, Codex, OpenCode и других: работа принята, только если пройдены проверки, которые агент не писал
Мост между локальными CLI-агентами: Codex, Cursor или Claude Code делегируют работу Antigravity, Grok, Kimi и еще семи агентам.
PaiCLI Python — терминальный ИИ-агент: ReAct и планирование, MCP-клиент, память, снимки перед правками и Runtime API.
Коротко о README
Две идеи держат проект вместе: постоянство хранения и принцип, что инструменты поставляет клиент. Репозиторий содержит только агента, а клиентов для терминала, IDE и браузера развивают отдельно.