TeamCity CLI Help

Glossary

This glossary defines the key terms used in TeamCity CLI and maps them to their TeamCity equivalents.

Run

A single execution of a build configuration. Equivalent to build in the TeamCity web interface.

teamcity run list teamcity run start MyProject_Build

Job

A set of instructions for running a build. Equivalent to build configuration in the TeamCity web interface.

teamcity job list teamcity job view MyProject_Build

Project

A collection of build configurations (jobs) with an associated name and description. Projects can be nested to form a hierarchy.

teamcity project list teamcity project view MyProject

Build Queue

A list of builds waiting to be assigned to an available agent. Builds in the queue are distributed to compatible agents as resources become available. The queue can be reordered manually.

teamcity queue list teamcity queue top 12345

Build Agent

A piece of software that executes builds. Agents are installed on separate machines and are assigned builds based on their compatibility with build configurations.

teamcity agent list teamcity agent view Agent-Linux-01

Agent Pool

A named group of build agents. Projects can be linked to pools to control which agents run their builds.

teamcity pool list teamcity pool view 1

Change

A modification to source code detected by TeamCity. A change is considered pending when it has been committed to the VCS but not yet included in a build.

teamcity run changes 12345

Personal Build

A build initiated by a developer to test local changes without affecting the main build history. In TeamCity CLI, personal builds are triggered using the --local-changes flag.

teamcity run start MyProject_Build --local-changes

Alias

A custom command shortcut that expands into a full teamcity command. Aliases support positional arguments and shell expressions.

teamcity alias set rl 'run list' teamcity alias list

Skill

A bundled configuration file that teaches AI coding agents (Claude Code, Cursor, and others) how to use TeamCity CLI. Skills follow the Agent Skills specification.

teamcity skill install teamcity skill update

Terminology mapping

CLI term

TeamCity term

run

build

job

build configuration

project

project

queue

build queue

agent

build agent

pool

agent pool

22 February 2026