winget install --id=JetBrains.TeamCityCLI -e teamcity is a command-line interface for interacting with TeamCity CI/CD server. Manage builds, jobs, and projects without leaving your terminal.
TeamCity CLI (teamcity) is an open-source command-line interface for TeamCity. Start builds, tail logs, manage agents and queues – without leaving your terminal.
> Documentation – full guide with installation, authentication, and command reference.
teamcity agent term, or run commands with teamcity agent execteamcity run watch --logs--json and --plain output for pipelines, plus direct REST API access via teamcity apiteamcity skill installmacOS (Homebrew):
brew install jetbrains/utils/teamcity
Linux:
curl -fsSL https://jb.gg/tc/install | bash
Windows (Winget):
winget install JetBrains.TeamCityCLI
More installation methods (deb, rpm, Chocolatey, Scoop, build from source)
Debian/Ubuntu:
curl -fsSLO https://github.com/JetBrains/teamcity-cli/releases/latest/download/teamcity_linux_amd64.deb
sudo dpkg -i teamcity_linux_amd64.deb
RHEL/Fedora:
sudo rpm -i https://github.com/JetBrains/teamcity-cli/releases/latest/download/teamcity_linux_amd64.rpm
Arch Linux:
curl -fsSLO https://github.com/JetBrains/teamcity-cli/releases/latest/download/teamcity_linux_amd64.pkg.tar.zst
sudo pacman -U teamcity_linux_amd64.pkg.tar.zst
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.cmd
Chocolatey:
choco install teamcitycli
Scoop:
scoop bucket add jetbrains https://github.com/JetBrains/scoop-utils
scoop install teamcity
Build from source:
go install github.com/JetBrains/teamcity-cli/tc@latest
See the getting started guide for the full walkthrough.
# Authenticate with your TeamCity server
teamcity auth login
# List recent builds
teamcity run list --limit 10
# Start a build and watch it run
teamcity run start MyProject_Build --branch main --watch
# View logs from the latest build of a job
teamcity run log --job MyProject_Build
# Check what's in the queue
teamcity queue list
> Note: The CLI uses "run" for builds and "job" for build configurations. See the glossary for the full mapping.
| Group | Commands |
|---|---|
| auth | login, logout, status |
| run | list, start, view, watch, log, 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, tree, param, token get/put, settings export/status/validate |
| queue | list, approve, remove, top |
| agent | list, view, term, exec, jobs, authorize/deauthorize, enable/disable, move, reboot |
| pool | list, view, link/unlink |
| api | Raw REST API access |
| alias | set, list, delete |
| skill | install, remove, update |
Run teamcity --help for usage details. See the command reference for full documentation.
An Agent Skill is included with teamcity. It teaches AI coding agents how to use teamcity for common TeamCity workflows.
teamcity skill install # auto-detects installed agents (Claude Code, Cursor, etc.)
teamcity skill install --project # install to current project only
teamcity skill update # update to latest version bundled with teamcity
teamcity skill remove # uninstall
or specifically for Claude Code:
/plugin marketplace add JetBrains/teamcity-cli
/plugin install teamcity-cli@teamcity-cli
See AI agent integration for details.
TeamCity CLI is open source under the Apache-2.0 license. Contributions are welcome – see CONTRIBUTING.md for setup instructions and guidelines.
Apache-2.0