teamcity-cli

TeamCity CLI

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.

Features

• Stay in your terminal – Start builds, view logs, manage queues – no browser needed
• Remote agent access – Shell into any build agent with teamcity agent term, or run commands with teamcity agent exec
• Real-time logs – Stream build output as it happens with teamcity run watch --logs
• Scriptable – --json and --plain output for pipelines, plus direct REST API access via teamcity api
• Multi-server support – Authenticate with and switch between multiple TeamCity instances
• AI agent ready – Built-in skill for Claude Code, Cursor, and other AI coding agents – just run teamcity skill install

Installation

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

curl -fsSLO https://github.com/JetBrains/teamcity-cli/releases/latest/download/teamcity_linux_amd64.deb
sudo dpkg -i teamcity_linux_amd64.deb

sudo rpm -i https://github.com/JetBrains/teamcity-cli/releases/latest/download/teamcity_linux_amd64.rpm

yay -S teamcity-bin

irm https://jb.gg/tc/install.ps1 | iex

curl -fsSL https://jb.gg/tc/install.cmd -o install.cmd && install.cmd && del install.cmd

choco install teamcitycli

scoop bucket add jetbrains https://github.com/JetBrains/scoop-utils
scoop install teamcity

go install github.com/JetBrains/teamcity-cli/tc@latest

Quick start

# Authenticate with your TeamCity server
teamcity auth login

# List recent builds
teamcity run list --limit 10

# List your favorite builds
teamcity run list --favorites --limit 10

# List my latest build for the current branch
teamcity run list --user @me --branch @this --limit 1

# 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.

Commands