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 is the official command-line client for TeamCity. It covers the day-to-day — starting builds, tailing logs, digging through the queue — and the odd jobs too: shelling into build agents, editing job settings, raw REST calls when nothing else fits.
Full documentation, including installation, authentication, and a command reference, lives at jb.gg/tc/docs.
Install
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)
# my latest build on this branch
teamcity run list --user @me --branch @this --limit 1
# start a build and stay attached to it
teamcity run start MyProject_Build --branch main --watch
# logs from the latest build of a job
teamcity run log --job MyProject_Build
# what's sitting in the queue
teamcity queue list
# shell into a build agent
teamcity agent term Agent-Linux-01
One naming note: TeamCity says build and build configuration; the CLI says run and job. The glossary has the full mapping.
Every command takes --json or --plain for scripting, and --web opens the matching page in the TeamCity UI. When no command covers what you need, teamcity api calls the REST API directly with your stored credentials. You can also log in to several servers and switch between them — see configuration.
The CLI ships with an Agent Skill that teaches coding agents (Claude Code, Cursor, and others) how to drive teamcity:
teamcity skill install # auto-detects installed agents
teamcity skill install --project # install to current project only
teamcity skill update # update to the version bundled with teamcity
teamcity skill remove # uninstall
TeamCity CLI is open source under the Apache-2.0 license. Bug reports and pull requests are welcome — CONTRIBUTING.md covers how the project is built and tested.