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.