TeamCity CLI

TeamCity CLI (teamcity) is a command-line interface for TeamCity. Start builds, tail logs, manage agents and queues — without leaving your terminal.

The project is open source on GitHub under the Apache-2.0 license.

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

Installing TeamCity CLI

Homebrew (recommended):

brew install jetbrains/utils/teamcity

Install script:

curl -fsSL https://jb.gg/tc/install | bash

Winget (recommended):

winget install JetBrains.TeamCityCLI

PowerShell (install script):

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

For other methods (Scoop, Chocolatey, deb/rpm packages, building from source), see the getting started guide.

Quick start

# 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

For a full walkthrough, see Getting started with TeamCity CLI.

What you can do

Topic	Description
Getting started	Install, authenticate, and run your first commands
Authentication	Token storage, guest access, multi-server setup, and CI/CD usage
Configuration	Configuration file, environment variables, and shell completion
Managing runs	Start, monitor, and manage builds
Managing jobs	View and configure build configurations
Managing projects	Browse projects, manage parameters and versioned settings
Managing the build queue	Inspect queued builds, control priority, and approve builds
Managing agents	Monitor, control, and access build agents remotely
Managing agent pools	Assign projects and agents to pools
REST API access	Make authenticated API requests from the command line
Aliases	Create custom command shortcuts
Scripting and automation	JSON output, plain text mode, and CI/CD integration
Command reference	Quick reference for all available commands and flags
AI agent integration	Install the TeamCity skill for AI coding agents

22 February 2026