Command Reference

This page provides a quick reference for all available TeamCity CLI commands. Each command group links to a detailed page with full descriptions, flags, and examples.

Authentication

Manage server authentication. See Authentication for details.

Command	Description
`teamcity auth login`	Authenticate with a TeamCity server
`teamcity auth logout`	Log out from a TeamCity server
`teamcity auth status`	Show authentication status

Runs

Start, monitor, and manage builds. See Managing runs for details.

Command	Description
`teamcity run artifacts`	List run artifacts
`teamcity run cancel`	Cancel a running build
`teamcity run changes`	Show VCS changes in a run
`teamcity run comment`	Set or view run comment
`teamcity run download`	Download run artifacts
`teamcity run list`	List recent runs
`teamcity run log`	View run log
`teamcity run pin`	Pin a run to prevent cleanup
`teamcity run restart`	Restart a run
`teamcity run start`	Start a new run
`teamcity run tag`	Add tags to a run
`teamcity run tests`	Show test results for a run
`teamcity run unpin`	Unpin a run
`teamcity run untag`	Remove tags from a run
`teamcity run view`	View run details
`teamcity run watch`	Watch a run until it completes

Jobs

View and configure build configurations. See Managing jobs for details.

Command	Description
`teamcity job list`	List jobs
`teamcity job param delete`	Delete a job parameter
`teamcity job param get`	Get a job parameter value
`teamcity job param list`	List job parameters
`teamcity job param set`	Set a job parameter value
`teamcity job pause`	Pause a job
`teamcity job resume`	Resume a paused job
`teamcity job tree`	Display snapshot dependency tree
`teamcity job view`	View job details

Projects

Browse projects and manage parameters and settings. See Managing projects for details.

Command	Description
`teamcity project list`	List projects
`teamcity project param delete`	Delete a project parameter
`teamcity project param get`	Get a project parameter value
`teamcity project param list`	List project parameters
`teamcity project param set`	Set a project parameter value
`teamcity project settings export`	Export project settings as Kotlin DSL or XML
`teamcity project settings status`	Show versioned settings sync status
`teamcity project settings validate`	Validate Kotlin DSL configuration locally
`teamcity project token get`	Get the value of a secure token
`teamcity project token put`	Store a secret and get a secure token
`teamcity project tree`	Display project hierarchy as a tree
`teamcity project view`	View project details

Queues

Manage the build queue. See Managing the build queue for details.

Command	Description
`teamcity queue approve`	Approve a queued run
`teamcity queue list`	List queued runs
`teamcity queue remove`	Remove a run from the queue
`teamcity queue top`	Move a run to the top of the queue

Agents

Monitor and control build agents. See Managing agents for details.

Command	Description
`teamcity agent authorize`	Authorize an agent
`teamcity agent deauthorize`	Deauthorize an agent
`teamcity agent disable`	Disable an agent
`teamcity agent enable`	Enable an agent
`teamcity agent exec`	Execute command on agent
`teamcity agent jobs`	Show jobs an agent can run
`teamcity agent list`	List build agents
`teamcity agent move`	Move an agent to a different pool
`teamcity agent reboot`	Reboot an agent
`teamcity agent term`	Open interactive terminal to agent
`teamcity agent view`	View agent details

Agent Pools

Manage agent pool assignments. See Managing agent pools for details.

Command	Description
`teamcity pool link`	Link a project to an agent pool
`teamcity pool list`	List agent pools
`teamcity pool unlink`	Unlink a project from an agent pool
`teamcity pool view`	View pool details

API

Make raw REST API requests. See REST API access for details.

Command	Description
`teamcity api <endpoint>`	Make an authenticated API request

Aliases

Create custom command shortcuts. See Aliases for details.

Command	Description
`teamcity alias delete`	Delete an alias
`teamcity alias list`	List configured aliases
`teamcity alias set`	Create a command alias

Skills

Manage AI agent integration. See AI agent integration for details.

Command	Description
`teamcity skill install`	Install the teamcity-cli skill for AI coding agents
`teamcity skill remove`	Remove the teamcity-cli skill from AI coding agents
`teamcity skill update`	Update the teamcity-cli skill for AI coding agents

23 February 2026