teamcity-cli
JetBrains/teamcity-cliCLI-инструмент для TeamCity: запуск сборок, просмотр логов, управление агентами и очередями. Поддерживает несколько серверов, JSON-вывод для скриптов и встроенный скилл для Claude Code и других AI-агентов.
Установка
npm install -g @jetbrains/teamcity-cliREADME
TeamCity CLI
TeamCity CLI (teamcity) — это open-source интерфейс командной строки для TeamCity. Запускайте сборки, следите за логами, управляйте агентами и очередями — не выходя из терминала.
Документация — полное руководство по установке, аутентификации и командам.
Возможности
- Работа в терминале — запуск сборок, просмотр логов, управление очередями без браузера
- Удалённый доступ к агентам — откройте shell на любом агенте сборки через
teamcity agent termили выполняйте команды черезteamcity agent exec - Логи в реальном времени — стримите вывод сборки по мере выполнения с помощью
teamcity run watch --logs - Поддержка скриптов — флаги
--jsonи--plainдля пайплайнов, прямой доступ к REST API черезteamcity api - Несколько серверов — аутентификация и переключение между несколькими экземплярами TeamCity
- Готов для AI-агентов — встроенный скилл для Claude Code, Cursor и других AI-агентов — просто выполните
teamcity skill install
Установка
macOS (Homebrew):
brew install jetbrains/utils/teamcity
Linux:
curl -fsSL https://jb.gg/tc/install | bash
Windows (Winget):
winget install JetBrains.TeamCityCLI
npm:
npm install -g @jetbrains/teamcity-cli
Debian/Ubuntu:
curl -fsSLO https://github.com/JetBrains/teamcity-cli/releases/latest/download/teamcity_linux_amd64.deb
sudo dpkg -i teamcity_linux_amd64.debRHEL/Fedora:
sudo rpm -i https://github.com/JetBrains/teamcity-cli/releases/latest/download/teamcity_linux_amd64.rpmArch Linux (AUR):
yay -S teamcity-bin
PowerShell:
irm https://jb.gg/tc/install.ps1 | iex
CMD:
curl -fsSL https://jb.gg/tc/install.cmd -o install.cmd && install.cmd && del install.cmdChocolatey:
choco install teamcitycli
Scoop:
scoop bucket add jetbrains https://github.com/JetBrains/scoop-utils
scoop install teamcityСборка из исходников:
go install github.com/JetBrains/teamcity-cli/tc@latest
См. руководство по началу работы для полного описания.
Быстрый старт
# Аутентификация на сервере TeamCity
teamcity auth login
# Список последних сборок
teamcity run list --limit 10
# Список избранных сборок
teamcity run list --favorites --limit 10
# Последняя сборка текущей ветки для текущего пользователя
teamcity run list --user @me --branch @this --limit 1
# Запустить сборку и следить за выполнением
teamcity run start MyProject_Build --branch main --watch
# Просмотр логов последней сборки задания
teamcity run log --job MyProject_Build
# Проверить содержимое очереди
teamcity queue listПримечание: CLI использует термин «run» для сборок и «job» для конфигураций сборок. См. глоссарий для полного соответствия терминов.
Команды
| Группа | Команды |
|---|---|
| auth | login, logout, status |
| run | list, start, view, watch, log, tree, changes, tests, cancel, download, artifacts, restart, pin/unpin, tag/untag, comment |
| job | list, view, tree, pause/resume, param list/get/set/delete |
| project | list, view, create, tree, vcs list/view/create/test/delete, ssh list/generate/upload/delete, cloud profile/image/instance, connection list, param, token get/put, settings export/status/validate |
| pipeline | list, view, create, validate, pull, push, delete |
| queue | list, approve, remove, top |
| agent | list, view, term, exec, jobs, authorize/deauthorize, enable/disable, move, reboot |
| pool | list, view, link/unlink |