Telemetry

The Together CLI sends anonymous usage events to help Together understand how the CLI is used and prioritize fixes and features.

Telemetry applies only when you use the together command-line tool. It is separate from the Python SDK’s behavior unless you invoke the CLI.

How to opt out

Telemetry tracking can be opted out via an environment variable TOGETHER_TELEMETRY_DISABLED or via tg telemetry disable which saves a local configuration file on disk.

TOGETHER_TELEMETRY_DISABLED=1 tg files upload ./data.jsonl

Below is a set of commands that can be used to disable/enable telemetry and check the status.

Command	What it does
telemetry status	Prints whether telemetry is enabled or disabled (and notes when the environment variable below is forcing it off).
telemetry disable	Disables telemetry via updates the config file.
telemetry enable	Enables telemetry via updates to the config file.

Config file location:

• macOS / Linux: $XDG_CONFIG_HOME/together/cli.json if XDG_CONFIG_HOME is set, otherwise ~/.config/together/cli.json.
• Windows: %APPDATA%\Together\cli.json.

The same file also stores a generated UUID as a stable, pseudonymous device identifier.

An example of the config file may look like this:

{
  "telemetry_enabled" true,
  "device_id": "7ba688c9-7e39-460a-9c96-ac518ab65605"
}

What is tracked?

The following below is a list of the type of data we collect for all events:

timestamp	Millisecond timestamp when the event was built.
session_id	Identifier for this CLI process (stable for the lifetime of the process).
device_id	Stable pseudonymous ID: a UUID stored in cli.json when first needed. We do not use any host hardware fingerprinting for this.
metadata	Various runtime metadata such as the together CLI version, operating system, and CPU architecture.
is_ci	true if the CI environment variable is set.
agent_detection	From detect_agent - we track if the command was invoked by an agent and which known agent.
command	The name of the command invoked, for example clusters create
arg_names	The name of any cli args passed in. We do not collect the values. For example, if you do --secret FOOBAR, we will record that a command was invoked with an argument secret, and we will not record the value FOOBAR.