v1.6.0

What's New

New Features

The run command now displays queued build compatibility information, giving users better visibility into why builds are waiting in the queue (for TeamCity 2026.3+).

Improvements

Date filters and search limits in the run command now have clearer help text and tips. Documentation examples for jq have been corrected to use proper build arrays.

Bug Fixes

Several output and API fixes have been applied: empty plain lists no longer include unwanted prose, selected false JSON fields are now preserved correctly, ignored test occurrence flags are no longer dropped, GET requests no longer send a request body, paginated responses correctly reject conflicting headers, 403 errors from API commands now report the authentication source, and the WebSocket URL now correctly preserves the server path prefix.

Changelog

• d82dd5a: feat(run): show queued compatibility (TW-104610) (#435) (jubi20)
• a12a5ca: fix(api): ignore body input on GET requests (#439) (Viktor (@tiulpin))
• 14b2f19: fix(api): reject headers with pagination (#440) (Viktor (@tiulpin))
• d850b61: fix(api): stamp auth source on api command 403 errors (TW-104682) (#434) (@jetbrains-air[bot])
• b288b5e: fix(docs): use build arrays in jq examples (#441) (Viktor (@tiulpin))
• adb5392: fix(output): keep empty plain lists free of prose (#443) (Viktor (@tiulpin))
• 621be94: fix(output): preserve selected false JSON fields (#444) (Viktor (@tiulpin))
• 6fa902f: fix(run): clarify date filters use start time (#438) (Viktor (@tiulpin))
• 76f5763: fix(run): clarify search limits in help and tips (#437) (Viktor (@tiulpin))
• af6a446: fix(run): preserve ignored test occurrence flags (#442) (Viktor (@tiulpin))
• b8673f4: fix(terminal): preserve server path prefix in WebSocket URL (TW-104792) (#436) (Cyrus (@Xm798))
• 16f7953: refactor(skills): consume migrate-to-teamcity from teamcity-skills too (#430) (Viktoria Petrenko (@vbedrosova))

Installation

macOS & Linux

Homebrew (recommended):

brew install jetbrains/utils/teamcity

Install script:

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

Debian/Ubuntu:

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

RHEL/Fedora:

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

Arch Linux (AUR):

yay -S teamcity-bin

Windows

Winget (recommended):

winget install JetBrains.TeamCityCLI

Chocolatey:

choco install TeamCityCLI

Scoop:

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

Manual:
Download teamcity_1.6.0_windows_x86_64.zip, extract, and add to PATH.

npm

npm install -g @jetbrains/teamcity-cli

Go Install

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

Quick Start

# Authenticate with your TeamCity server
teamcity auth login

# List recent builds
teamcity run list

# Start a build
teamcity run start MyProject_Build --branch main --watch

Full documentation — getting started, configuration, command reference, and more.