CircleCI CLI
circleci-cli
Официальный CLI CircleCI показывает запуски и логи упавших тестов, а skills и MCP подключают его к Claude Code, Codex и Cursor.
- 460 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Работает с вашим токеном CircleCI и может перезапускать задачи
- Передает агенту логи сборок, где бывают секреты и внутренние адреса
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/circleci-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Работает с вашим токеном CircleCI и может перезапускать задачи
- Передает агенту логи сборок, где бывают секреты и внутренние адреса
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
`circleci` — утилита командной строки CircleCI для работы с запусками, задачами и конфигурацией прямо из терминала. README называет ее agent-friendly, то есть удобной для работы ИИ-агентов. Для Claude Code и Codex CircleCI публикует отдельные skills в репозитории `CircleCI-Public/skills`: они учат агента проверять конфигурацию, следить за запуском, читать логи упавших задач и тестов и перезапускать задачи. Подсказку с шагами печатает `circleci help agents`. Кроме того, CLI умеет включать MCP для Claude desktop, Cursor и VS Code командами `circleci mcp <клиент> enable`.
Для кого. Командам, чьи сборки идут в CircleCI на circleci.com или в CircleCI server и которые хотят разбирать упавшие пайплайны, не выходя из чата с агентом.
Подходит, если
- Пайплайн упал, и агент должен прочитать логи задач и найти упавший тест.
- Перед пушем стоит проверить конфигурацию `.circleci/config.yml` из терминала.
- Нужно следить за запуском и перезапустить задачу после правки.
- Cursor или VS Code требуется подключить к CircleCI через MCP одной командой.
Не подходит, если
- Сборки идут в другом CI: CLI работает только с CircleCI.
- Агенту нельзя доверять токен CircleCI: CLI работает от токена после `circleci auth login`.
- Нужна замена веб-интерфейсу для настройки проекта: CLI сосредоточен на запусках и конфигурации.
Пример запроса к агенту
Покажи последний запуск пайплайна, найди упавшую задачу, прочитай логи с тестами и предложи исправление без перезапуска.Ограничения
После `circleci auth login` CLI работает от вашего токена, и агент действует от вашего имени. Skills лежат в отдельном репозитории `CircleCI-Public/skills`, а не в самом CLI. Установка skills для Cursor идет через `npx skills add` и требует Node 22.20 или новее. Перезапуск задач может расходовать кредиты плана CircleCI. Полный список команд и опции подключения MCP описаны в документации на cli.circleci.com, а в README перечислены лишь основные.
Как отключить. Удалите плагин `circleci` в Claude Code или Codex, выполните `circleci mcp <клиент> disable`, если включали MCP, и деинсталлируйте CLI тем менеджером пакетов, которым ставили. Сохраненный токен сотрите из настроек CLI.
Частые вопросы
Как поставить skills для разных агентов?
Для Claude Code: `claude plugin marketplace add CircleCI-Public/skills`, затем `claude plugin install circleci@circleci-public-skills`. Для Codex: `codex plugin marketplace add CircleCI-Public/skills` и `codex plugin add circleci@circleci-skills`.
Что делать в Cursor?
Выполните `npx skills add CircleCI-Public/skills -a cursor --skill circleci-cli`. Без Node папку skill копируют в `~/.cursor/skills/<имя>` вручную.
Как включить MCP?
`circleci mcp claude enable` для Claude desktop с последующим `claude mcp add-from-claude-desktop -s user`, `circleci mcp cursor enable` для Cursor и `circleci mcp vscode enable` для VS Code.
Какие способы установки CLI есть?
Homebrew (`brew install circleci`), winget для Windows, snap, а также пакеты apt, yum и dnf для Linux.
Работает ли CLI с CircleCI server?
Да, README заявляет поддержку и circleci.com, и CircleCI server на macOS, Windows и Linux.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыОфициальный CLI JetBrains для TeamCity: запуск сборок, хвост логов, очередь и шелл на агенте из терминала.
Официальный CLI Coralogix с 19 скиллами: агент читает логи, трассы и метрики продакшена и разбирает инциденты в терминале
Docker Skills
docker-skills
Официальные скиллы Docker для агентов: Dockerfile и сборка, Compose, Sandboxes, Docker Agent и скилл с подтверждением необратимых действий
Claude Code Tools
claude-code-tools
Набор практичных инструментов для Claude Code, Codex CLI и похожих агентов: утилиты, скиллы, агенты, хуки и плагины для работы в терминале
CLI и оператор Kubernetes, который запускает Claude Code, Codex, Gemini, OpenCode и Cursor как задачи и сессии в кластере
31 скилл для DevOps в Claude Code и Codex: генераторы конфигов, валидаторы и отладчик Kubernetes для Terraform, Helm, CI и Docker
Коротко о README
README открывает установку CLI, затем отдельным блоком дает команды для skills и MCP. Раздел `circleci help agents` дублирует шаги для агента прямо в терминале.