Skip to content

ts version

Print the version of the ts executable you are running. Reach for it when a command behaves differently than the documentation describes and you need to know which build is on the machine.

Usage

text
ts version

Description

ts version reports the CLI's own version and nothing else. It does not contact a server, so it works signed out, offline, and before any server has been configured.

The server's version is a separate thing, and this command will not tell you what it is — --server and --local are accepted, because every command accepts them, but they change nothing here. Use ts status for the version of the server you are administering. The two can legitimately differ: administrator workstations often run a newer ts than the servers they manage.

With --format=json the version also appears as a version field in the result envelope, which is the reliable way to gate a script on the CLI being new enough for a command.

Examples

bash
# Which ts is on this machine?
ts version

# For a script that needs to check the build
ts version --format=json
bash
# This reports the CLI on your workstation, not the server's version
ts --server=https://turbo.example.net version

Output

text
Turbo Server CLI version 1.0.0

With --format=json:

json
[{
  "name": "version",
  "arguments": ["version", "--format", "json"],
  "result": { "exitCode": 0, "version": "1.0.0" },
  "messages": ["Turbo Server CLI version 1.0.0"]
}]

Exit Codes

0, always. Nothing is looked up and no server is contacted, so the connection, sign-in, and not-found codes cannot occur.

  • ts status — The server's version, health, and topology.
  • ts help — Which commands this build supports.