TeamCity CLI (teamcity) is a command-line interface designed to interact with TeamCity CI/CD servers directly from your terminal. It enables developers and DevOps teams to manage builds, jobs, projects, and agents efficiently without switching to a web browser.
Key Features:
Real-time logs streaming for monitoring build progress.
Remote agent access via shell or command execution.
JSON output support for scripting and automation tasks.
Multi-server authentication and management capabilities.
Built-in AI skill integration for Claude Code and similar tools.
Direct REST API access for advanced customizations.
Audience & Benefit:
Ideal for developers, DevOps engineers, CI/CD pipeline maintainers, and TeamCity administrators. It increases productivity by enabling terminal-based workflow management, enhances efficiency through automation support, and provides real-time insights into build processes. The tool also simplifies the management of distributed development environments with its multi-server capabilities.
Installable via winget for Windows users.
README
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
More installation methods (deb, rpm, Chocolatey, Scoop, build from source)
# 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.