teamcity-cli

TeamCity CLI (teamcity)

Quick Start

teamcity auth status                    # Check authentication
teamcity run list --status failure      # Find failed builds
teamcity run log <id> --failed          # Full failure diagnostics

Do not guess flags or syntax. Use the [Command Reference](references/commands.md) or teamcity <command> --help. Fall back to teamcity api /app/rest/... when needed. Builds are runs (teamcity run), build configurations are jobs (teamcity job).

Core Commands

| Area | Commands |

|-----------|---------------------------------------------------------------------------------------------------|

| Builds | run list, view, start, watch, log, cancel, restart, tests, changes |

| Artifacts | run artifacts, run download |

| Metadata | run pin/unpin, run tag/untag, run comment |

| Jobs | job list, view, tree, pause/resume, param list/get/set/delete |

| Projects | project list, view, tree, param, token put/get, settings export/status/validate |

| Queue | queue list, approve, remove, top |

| Agents | agent list, view, enable/disable, authorize/deauthorize, exec, term, reboot, move |

| Pools | pool list, view, link/unlink |

| API | teamcity api <endpoint> — raw REST API access |

Quick Workflows

Investigate failure: teamcity run list --status failure → teamcity run log <id> --failed → teamcity run tests <id> --failed

From a URL: Extract build ID from https://host/buildConfiguration/ConfigId/12345 → teamcity run view 12345

Start build: teamcity run start <job-id> --branch <branch> --watch

Find jobs: teamcity project list → teamcity job list --project <id>

Validate Kotlin DSL: teamcity project settings validate (not mvn compile — see [Workflows](references/workflows.md))

References

• [Command Reference](references/commands.md) - All commands and flags
• [Workflows](references/workflows.md) - URL handling, failure investigation, artifacts, agents, and more
• [Output Formats](references/output.md) - JSON, plain text, scripting