v0.8.2

TeamCity CLI Release Notes

New Features

• Added initial support for sandboxed environments, enabling isolated execution contexts for builds and commands.

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/v0.8.2/teamcity_linux_amd64.deb
sudo dpkg -i teamcity_linux_amd64.deb

RHEL/Fedora:

sudo rpm -i https://github.com/JetBrains/teamcity-cli/releases/download/v0.8.2/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_0.8.2_windows_x86_64.zip, extract, and add to PATH.

Go Install

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

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.

v0.8.1

New Features

• Build watch with JSON output: The run watch command now supports --json output, making it easier to integrate build monitoring into scripts and pipelines.
• Client certificate support: Certificates stored in the OS certificate store are now supported on Windows and macOS, enabling authentication without managing certificate files manually.

Improvements

• Better error messages: Error responses from the server, including XML and HTML formats, are now parsed and presented more clearly.

Bug Fixes

• Fixed an issue where build state was not refreshed during run progress updates.
• Restored the missing --json flag on the run watch command.
• Fixed a URL normalization issue where leading or trailing whitespace in server URLs caused connection failures.
• Fixed a hint in run watch to correctly suggest --logs when resuming a build with log output.
• Fixed API endpoint URLs being misinterpreted by the shell due to missing quotes.
• Fixed inconsistent depth increments when rendering build configuration trees.

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/v0.8.1/teamcity_linux_amd64.deb
sudo dpkg -i teamcity_linux_amd64.deb

RHEL/Fedora:

sudo rpm -i https://github.com/JetBrains/teamcity-cli/releases/download/v0.8.1/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_0.8.1_windows_x86_64.zip, extract, and add to PATH.

Go Install

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

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.

v0.8.0

New Features

• PKCE-based authentication: Added a new OAuth 2.0 PKCE authentication flow for more secure browser-based login.
• Mutual TLS (mTLS) support: Client certificate authentication is now supported for organizations requiring mTLS connections to TeamCity.
• Subdirectory and recursive artifact downloads: Artifact fetching now supports downloading from subdirectories and traversing nested artifact paths.
• Configurable download timeout: A new --timeout flag is available on the run download command to set a custom time limit for artifact downloads.

Improvements

• Authentication diagnostics: Improved error messages and diagnostics when token retrieval fails, including clearer keyring fallback reporting.
• Browser launch fallback: If the browser cannot be opened during authentication, the CLI now displays the authentication URL directly in the terminal.
• Unauthenticated error handling: Refined suggestions for guest access and improved handling of unauthenticated error responses.
• Install script enhancements: Install scripts now support version selection, GitHub token input, and provide better error handling during installation.

Bug Fixes

• Fixed inconsistent API path formatting where leading slashes were sometimes missing.
• Fixed a non-TTY fallback issue in watch mode that could cause failures in non-interactive environments.
• Fixed incorrect authorization header formatting in the install script's curl invocation.

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/v0.8.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/v0.8.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_0.8.0_windows_x86_64.zip, extract, and add to PATH.

Go Install

go install github.com/JetBrains/teamcity-cli/tc@v0.8.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.

v0.7.2

New Features

• auth status now lists all configured servers. Running auth status displays the full list of servers you have configured, giving you a complete overview of your authentication state at a glance.

Bug Fixes

• Fixed a spurious timeout during terminal readiness check. Removed a redundant timeout case that could cause unnecessary delays or incorrect behavior when initializing the terminal.

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/v0.7.2/teamcity_linux_amd64.deb
sudo dpkg -i teamcity_0.7.2_linux_amd64.deb

RHEL/Fedora:

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

Arch Linux:

curl -fsSLO https://github.com/JetBrains/teamcity-cli/releases/download/v0.7.2/teamcity_linux_amd64.pkg.tar.zst
sudo pacman -U teamcity_linux_amd64.pkg.tar.zst

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_0.7.2_windows_x86_64.zip, extract, and add to PATH.

Go Install

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

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.

v0.7.0

New Features

• Read-only mode: Protect against accidental write operations by enabling read-only mode via the ro config option or the TEAMCITY_RO environment variable.
• Tree view for projects and jobs: New tree commands provide a hierarchical view of projects and build configurations.
• Guest authentication: The CLI now supports connecting to TeamCity servers using guest authentication.
• Enhanced test failure details: Test occurrence output now includes newFailure status and firstFailed metadata, making it easier to identify newly introduced failures.

Improvements

• Build queries are now restricted to completed builds, preventing incomplete or running builds from appearing in results unexpectedly.
• Full multi-line failure summaries are now displayed in test details output, replacing the previous truncated single-line behavior.

Bug Fixes

• Fixed @me not resolving the current username via the API when it was absent from the local config.
• Fixed username resolution failure during terminal authentication fallback.
• Fixed parsing of colon-separated key-value strings, which were not being correctly handled as JSON maps.
• Fixed alias overwrite behavior to work correctly when re-registering existing aliases.

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/v0.7.0/teamcity_0.7.0_linux_amd64.deb
sudo dpkg -i teamcity_0.7.0_linux_amd64.deb

RHEL/Fedora:

sudo rpm -i https://github.com/JetBrains/teamcity-cli/releases/download/v0.7.0/teamcity_0.7.0_linux_amd64.rpm

Arch Linux:

curl -fsSLO https://github.com/JetBrains/teamcity-cli/releases/download/v0.7.0/teamcity_0.7.0_linux_amd64.pkg.tar.zst
sudo pacman -U teamcity_0.7.0_linux_amd64.pkg.tar.zst

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_0.7.0_windows_x86_64.zip, extract, and add to PATH.

Go Install

go install github.com/JetBrains/teamcity-cli/tc@v0.7.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.

Changelog

• ef3482f: fix(cmd): parse colon-separated key-value strings as JSON map during unmarshalling (@tiulpin)
• fefacb4: fix(cmd): restrict build fetch to completed states with State: finished (@tiulpin)
• 98b344e: fix(cmd): ensure @me resolves username via API when not found in config (@tiulpin)
• b660e40: feat(api, cmd): enhance test occurrence details with newFailure tracking and firstFailed metadata (@tiulpin)
• b636e99: fix(cmd): display all lines of test details in failure_summary output and remove obsolete firstLine function (@tiulpin)
• 7dccccc: feat: add read-only mode via ro config and TEAMCITY_RO environment variable (#112) (@tiulpin)
• f6f2da8: fix(cmd): resolve missing username for terminal authentication fallback (@tiulpin)
• e331af1: feat: add end-to-end acceptance test framework using testscript (@claude)
• 3233c92: feat(cmd): add tree commands for projects and jobs (@tiulpin)
• c35c3f2: fix(alias): add test for overwriting registered aliases and update alias annotations (@tiulpin)
• b7e0204: feat(auth, api, tests): add guest authentication support (@tiulpin)

v0.6.0

⚠️ Breaking change: the binary has been renamed from tc to teamcity.

If you installed via Homebrew, Scoop, or a package manager, just upgrade — the new binary name is picked up automatically. If you have scripts or aliases referencing tc, update them to use teamcity instead.

New Features

• Alias support — Define custom command aliases in your configuration to create shortcuts for frequently used commands (#91)
• Artifact subpath browsing — teamcity run artifacts now supports browsing into subdirectories of build artifacts
• System keyring integration — Authentication tokens are now stored securely in your OS keyring (macOS Keychain, Windows Credential Manager, Linux secret service) with a --insecure-storage fallback

Bug Fixes

• Binary renamed from tc to teamcity — Avoids conflicts with existing tc utilities on Linux systems (#103)

Changelog

• f98da51: feat(api, cmd): add support for subpath browsing in GetArtifacts and tc run artifacts (@tiulpin)
• af994b9: feat(auth): integrate system keyring for secure token storage with fallback options (@tiulpin)
• af99b22: feat(config): add alias support (#91) (@tiulpin)
• f005605: fix(teamcity): rename binary from tc to teamcity (#103) (@tiulpin)

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/v0.6.0/teamcity_0.6.0_linux_amd64.deb
sudo dpkg -i teamcity_0.6.0_linux_amd64.deb

RHEL/Fedora:

sudo rpm -i https://github.com/JetBrains/teamcity-cli/releases/download/v0.6.0/teamcity_0.6.0_linux_amd64.rpm

Arch Linux:

curl -fsSLO https://github.com/JetBrains/teamcity-cli/releases/download/v0.6.0/teamcity_0.6.0_linux_amd64.pkg.tar.zst
sudo pacman -U teamcity_0.6.0_linux_amd64.pkg.tar.zst

Windows

Winget (recommended):

winget install JetBrains.TeamCityCLI

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

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

Go Install

go install github.com/JetBrains/teamcity-cli/tc@v0.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

See the README for full documentation.

v0.5.0

New Features

• Windows installation scripts — Added PowerShell and CMD installers for easy setup on Windows
• Cross-branch run listing — tc run list now supports listing runs across all branches
• AI agent skill management — New commands to install, update, and remove AI agent skills

Bug Fixes

• Fixed server URL normalization for edge cases
• Added --revision flag and fixed personal builds
• Improved table output with dynamic column sizing
• Build IDs now included in formatted output

Changelog

• 3a1ebe4: feat(install): add installation scripts for Windows (CMD, PowerShell) (@tiulpin)
• 4dee027: feat(run): add support for listing runs across all branches (@tiulpin)
• 09111e9: feat(skill): add commands to install, update, and remove AI agent skills (@tiulpin)
• 65bce33: fix(config): normalize server URLs and add tests for edge cases (@tiulpin)
• 120b616: fix(goreleaser): add file_name_template for consistent package naming (@tiulpin)
• 7393632: fix(install): remove unnecessary ASCII art from Windows installer script (@tiulpin)
• 3b825d2: fix(output): include build IDs in formatted output strings for improved clarity (@tiulpin)
• da1fd22: fix(output): replace ColumnWidths with AutoSizeColumns for dynamic table sizing (@tiulpin)
• 6522059: fix(run): add --revision and fix personal builds (@tiulpin)

Installation

macOS & Linux

Homebrew (recommended):

brew install jetbrains/utils/tc

Install script:

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

Debian/Ubuntu:

curl -fsSLO https://github.com/JetBrains/teamcity-cli/releases/download/v0.5.0/tc_0.5.0_linux_amd64.deb
sudo dpkg -i tc_0.5.0_linux_amd64.deb

RHEL/Fedora:

sudo rpm -i https://github.com/JetBrains/teamcity-cli/releases/download/v0.5.0/tc_0.5.0_linux_amd64.rpm

Arch Linux:

curl -fsSLO https://github.com/JetBrains/teamcity-cli/releases/download/v0.5.0/tc_0.5.0_linux_amd64.pkg.tar.zst
sudo pacman -U tc_0.5.0_linux_amd64.pkg.tar.zst

Windows

Winget (recommended):

winget install JetBrains.tc

Chocolatey:

choco install tc

Scoop:

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

Manual:
Download tc_0.5.0_windows_x86_64.zip, extract, and add to PATH.

Go Install

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

Quick Start

# Authenticate with your TeamCity server
tc auth login

# List recent builds
tc run list

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

See the README for full documentation.

v0.4.0

New Features

• Build artifacts — New tc run artifacts command to browse and download build artifacts (#67)
• Agent reboot — Reboot agents directly from the CLI (#41)
• Project settings validation — New tc project settings validate command for local DSL validation
• Watch improvements — Added --quiet, --timeout flags and meaningful exit codes to tc run watch
• Flexible agent selection — Agent commands now accept both names and IDs
• Improved failure summaries — Better statusText, test details, and problem filtering in build output

Bug Fixes

• Fixed locator value escaping to prevent injection
• Fixed --since/--until date range validation
• Fixed job list to include subprojects via affectedProject
• Fixed pool name/ID resolution in agent list --pool
• Rejected invalid inputs: empty tags, non-positive --limit, negative durations, minimum 1s --interval

Changelog

• 4012535: feat(api): Refactor authentication logic, add DownloadArtifactTo method, and improve artifact handling in tests (@tiulpin)
• 58e46dd: feat(api, cmd): Add agent reboot functionality with API and CLI support (#41) (@tiulpin)
• b324dc2: feat(cmd): Add --quiet, --timeout, exit codes to watch; improve log --failed (@tiulpin)
• 05f63f8: feat(cmd): Add tc project settings validate command to validate DSL configuration locally (@tiulpin)
• 403639b: feat(cmd): Allow agent commands to accept names or IDs for improved usability (@tiulpin)
• a70132e: feat(cmd): Fix DSL status in project settings status (@tiulpin)
• 758ad9e: feat(cmd): Improve failure summary with statusText, test details, and problem filtering (@tiulpin)
• d4109f8: feat(cmd, api): Add tc run artifacts command and enhance artifacts API handling (#67) (@tiulpin)
• 5063877: feat(config): Add DSL directory and server detection logic (@tiulpin)
• c0020c3: fix(api): align struct tag formatting in BuildType for consistency (@tiulpin)
• 1facf3b: fix(api): correct not-found hint for agent pool errors (@tiulpin)
• 72b80db: fix(api): escape closing parens in locator values to prevent injection (@tiulpin)
• b971773: fix(api): reject negative durations in date parsing (@tiulpin)
• 7435abc: fix(api): use pointer for BuildType.Project so omitempty works (@tiulpin)
• 21079bd: fix(api): use strconv.Atoi for strict pool ID parsing (@tiulpin)
• 6102ffe: fix(cmd): error on backwards --since/--until date range (@tiulpin)
• 605a995: fix(cmd): improve validation error message for run status display (@tiulpin)
• 623690c: fix(cmd): include version in CLI output (@tiulpin)
• e29bf03: fix(cmd): reject empty tags in run tag command (@tiulpin)
• a982393: fix(cmd): reject non-positive --limit values in list commands (@tiulpin)
• bcdb3da: fix(cmd): resolve pool name/id in agent list --pool filter (@tiulpin)
• 40a1593: fix(cmd): use affectedProject in job list to include subprojects (@tiulpin)
• ede0453: fix(cmd): validate --interval to enforce minimum of 1 second in run watch (@tiulpin)

Installation

macOS & Linux

Homebrew (recommended):

brew install jetbrains/utils/tc

Install script:

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

Debian/Ubuntu:

curl -fsSLO https://github.com/JetBrains/teamcity-cli/releases/download/v0.4.0/tc_0.4.0_linux_amd64.deb
sudo dpkg -i tc_0.4.0_linux_amd64.deb

RHEL/Fedora:

sudo rpm -i https://github.com/JetBrains/teamcity-cli/releases/download/v0.4.0/tc_0.4.0_linux_amd64.rpm

Arch Linux:

curl -fsSLO https://github.com/JetBrains/teamcity-cli/releases/download/v0.4.0/tc_0.4.0_linux_amd64.pkg.tar.zst
sudo pacman -U tc_0.4.0_linux_amd64.pkg.tar.zst

Windows

Winget (recommended):

winget install JetBrains.tc

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 tc

Scoop:

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

Manual:
Download tc_0.4.0_windows_x86_64.zip, extract, and add to PATH.

Go Install

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

Quick Start

# Authenticate with your TeamCity server
tc auth login

# List recent builds
tc run list

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

See the README for full documentation.

v0.3.0

New Features

• Agent terminal — Open an interactive terminal session to agents via WebSocket connection
• Project settings export — New tc project settings export command (#31)
• Project settings status — New tc project settings status command for DSL sync info
• Build-level authentication — Automatic authentication when running inside TeamCity build steps (#50)
• Verbose logging — Debug HTTP requests and responses with sensitive data redaction (#48)

Bug Fixes

• Fixed terminal resize handling on all platforms (including Windows polling fallback)
• Fixed property file encoding to ISO-8859-1 for build-level auth

Changelog

• c169a52: feat(api): Add verbose logging for HTTP requests and responses with sensitive data redaction (#48) (@tiulpin)
• 81d31a0: feat(auth): Add build-level authentication support for TeamCity environments (#50) (@tiulpin)
• 9e76ebf: feat(cmd): Add terminal open command for agents in various views (@tiulpin)
• 9d50735: feat(cmd, api): Add tc project settings export command and API support for exporting project settings (#31) (@tiulpin)
• d9d75fd: feat(cmd, api): Add tc project settings status (@tiulpin)
• f7f98d6: feat(cmd, api): Add agent terminal and command execution support via WebSocket connection (@tiulpin)
• 285af60: fix(api): Add platform-specific terminal resize signal handling (@tiulpin)
• b2878bf: fix(api): Implement terminal resize polling for Windows platform (@tiulpin)
• 981b5df: fix(api, test): Simplify terminal command execution logic and update tests accordingly (@tiulpin)
• 8ebaf40: fix(config): Adjust property file encoding to ISO-8859-1 in build-level auth configuration (@tiulpin)

Installation

macOS & Linux

Homebrew (recommended):

brew install jetbrains/utils/tc

Install script:

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

Debian/Ubuntu:

curl -fsSLO https://github.com/JetBrains/teamcity-cli/releases/download/v0.3.0/tc_0.3.0_linux_amd64.deb
sudo dpkg -i tc_0.3.0_linux_amd64.deb

RHEL/Fedora:

sudo rpm -i https://github.com/JetBrains/teamcity-cli/releases/download/v0.3.0/tc_0.3.0_linux_amd64.rpm

Arch Linux:

curl -fsSLO https://github.com/JetBrains/teamcity-cli/releases/download/v0.3.0/tc_0.3.0_linux_amd64.pkg.tar.zst
sudo pacman -U tc_0.3.0_linux_amd64.pkg.tar.zst

Windows

Winget (recommended):

winget install JetBrains.tc

Scoop:

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

Manual:
Download tc_0.3.0_windows_x86_64.zip, extract, and add to PATH.

Go Install

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

Quick Start

# Authenticate with your TeamCity server
tc auth login

# List recent builds
tc run list

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

See the README for full documentation.

v0.2.0

New Features

• Agent and pool management — New commands to list, inspect, and manage agents and pools
• Personal builds — Run personal builds with local changes, including branch push handling
• AI agent skill — Bundled tc agent skill for AI-assisted workflows

Bug Fixes

• Prevented cancellation of already-finished builds
• Fixed redundant output for non-credentials JSON tokens

Changelog

• 3d6bb82: feat(api, cmd): Add support for personal builds with local changes (@tiulpin)
• c0fb04a: feat(cli): Add tc agent skill to the repo (@tiulpin)
• 26ef4dd: feat(cmd): Add support for managing agents and pools (@tiulpin)
• f82aae0: feat(cmd, api): Add HEAD commit and branch push handling for personal builds (@tiulpin)
• f63702d: fix(api): Prevent cancellation of finished builds and handle queued builds separately (@tiulpin)
• 66dbdf1: fix(cmd): Add Git helpers for repository interactions and support branch pushing (@tiulpin)
• 53da64e: fix(cmd): Avoid redundant output for non-credentials JSON tokens (@tiulpin)
• 56a8162: refactor(api, cmd): Add support for customizable fields when querying agents and pools (@tiulpin)

Installation

macOS & Linux

Homebrew (recommended):

brew install jetbrains/utils/tc

Install script:

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

Debian/Ubuntu:

curl -fsSLO https://github.com/JetBrains/teamcity-cli/releases/download/v0.2.0/tc_0.2.0_linux_amd64.deb
sudo dpkg -i tc_0.2.0_linux_amd64.deb

RHEL/Fedora:

sudo rpm -i https://github.com/JetBrains/teamcity-cli/releases/download/v0.2.0/tc_0.2.0_linux_amd64.rpm

Arch Linux:

curl -fsSLO https://github.com/JetBrains/teamcity-cli/releases/download/v0.2.0/tc_0.2.0_linux_amd64.pkg.tar.zst
sudo pacman -U tc_0.2.0_linux_amd64.pkg.tar.zst

Windows

Scoop:

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

Manual:
Download tc_0.2.0_windows_x86_64.zip, extract, and add to PATH.

Go Install

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

Quick Start

# Authenticate with your TeamCity server
tc auth login

# List recent builds
tc run list

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

See the README for full documentation.