Upgrade & Version

turing-cli upgrade checks for and installs new CLI versions. turing-cli version displays the current version, commit, build time, and running platform.

upgrade check

turing-cli upgrade check [flags]

Checks the version and write permissions only — does not modify any local files.

Flag	Default	Description
--version VERSION	latest	Target version; can be latest or a specific version number
--base-url URL	Release default URL	Root URL for upgrade metadata
--json	false	Output JSON, suitable for scripting or UI integration
-h, --help		Show command help

Examples:

turing-cli upgrade check
turing-cli upgrade check --json
turing-cli upgrade check --version 0.1.5-rc2

upgrade apply

turing-cli upgrade apply [flags]

Downloads and installs an available new version. Aliases:

turing-cli upgrade update
turing-cli upgrade run

Flag	Default	Description
--version VERSION	latest	Target version; can be latest or a specific version number
--base-url URL	Release default URL	Root URL for upgrade metadata
--json	false	Output JSON
-h, --help		Show command help

Upgrade process:

1. Download the manifest.
2. Select the artifact based on the current OS / arch.
3. Download the artifact.
4. Verify the SHA-256 checksum.
5. Decompress and replace the current turing-cli binary.

If any step fails, the old binary will not be replaced.

latest vs. prerelease

latest points only to stable releases. Prereleases such as 0.1.5-rc1 and 0.1.5-rc2 are uploaded to their respective version directories but do not advance latest.

turing-cli upgrade apply

This will only follow the stable latest. To install a prerelease, specify the version explicitly:

turing-cli upgrade apply --version 0.1.5-rc2

JSON Output

{
  "current_version": "0.1.5-rc1",
  "latest_version": "0.1.5-rc2",
  "status": "upgrade_available",
  "artifact_url": "https://.../turing-cli_0.1.5-rc2_Darwin_arm64.tar.gz",
  "writable": true,
  "installed": true
}

Common status values:

status	Meaning
latest	The current version is already at or above the target version
upgrade_available	A new version is available to install
unknown_current_version	The current binary is not a release build; version comparison is not possible
unsupported_platform	No installation package is available for the current OS / arch

version

turing-cli version

Example output:

turing-cli 0.1.5 (commit abc1234, built 2026-06-23T10:00:00Z, darwin/arm64)

Notes

• Windows does not currently support in-place replacement of a running binary; use the install script to reinstall.
• If the installation directory is not writable, apply will stop and report that the directory is not writable.
• If the SHA-256 verification fails, the old binary will not be replaced.
• go run or local development builds typically show as dev and will return unknown_current_version.