Knowledge Base

SCALE (Simple Cross-Platform Agent Language for Extensibility) is TeamViewer's cross-platform automation language for endpoint management and device operations. It provides a consistent way to execute diagnostic, remediation, and administrative tasks across Windows, macOS, and Linux devices. By combining built-in agent capabilities, flow control, structured outputs, and operating system integrations, SCALE helps organizations automate endpoint activities in a controlled and predictable manner. SCALE is used throughout TeamViewer automation workflows, including the approved tools available through Tia troubleshooting experiences.

This article applies to all TeamViewer ONE (Standard, Advanced, and Enterprise), Premium, Corporate, and Tensor license holders.

What is SCALE?

SCALE is a purpose-built automation language designed for endpoint management. It enables organizations to run diagnostic, remediation, information-gathering, and operational workflows directly on managed devices.

SCALE provides:

• Cross-platform execution across Windows, macOS, and Linux
• Consistent access to endpoint data and device capabilities
• Structured outputs that can be consumed by automation workflows
• Controlled execution through predefined logic and governance mechanisms

Within TeamViewer, SCALE powers endpoint automations, including many of the diagnostic and remediation tools surfaced through Tia and other managed workflows.

Background

SCALE was originally developed by 1E, where it powers Digital Employee Experience (DEX) endpoint automations. Following TeamViewer's acquisition of 1E, SCALE became part of TeamViewer and continues to serve as the foundation for endpoint automation capabilities across the platform.

How SCALE works

SCALE is intentionally compact and includes only the capabilities needed to perform endpoint automation safely and predictably. Its limited and well-defined language surface helps reduce unnecessary complexity and supports controlled execution. By relying on approved tooling and predefined actions, SCALE enables automation workflows that are predictable and governed.

The language is built around four core areas.

Flow control

SCALE supports decision-making and iteration through constructs such as:

IF / ELSE / ENDIF
FOREACH

These constructs allow a tool to evaluate conditions and process multiple items when needed.

Clean termination

A tool can end execution explicitly using commands such as:

EVALUATE
RETURN
NOCONTENT
ERROR
NOTIMPLEMENTED

These commands help ensure that every execution finishes in a clear and well-defined state.

Shell bridge

Some automation tasks require operating system capabilities available only through platform-specific commands. In these cases, approved tools can leverage capabilities such as PowerShell on Windows or shell commands on Linux and macOS.

These commands run as part of predefined tool logic while retaining the governance, execution controls, and structured result handling provided by SCALE.

Agent methods

SCALE includes a library of built-in cross-platform agent methods that can read device information and perform actions consistently across supported operating systems.

Example SCALE instruction

The following diagnostic instruction retrieves network configuration information from a Windows device:

// Diagnostic instruction — read-only by design
@result = Scripting.RunText(
   Language: "PowerShell",
   Text: "Get-NetIPConfiguration | ConvertTo-Json"
);
EVALUATE @result;   // stop early if nothing returned
RETURN @result;

In this example:

1. A PowerShell command retrieves network configuration data.
2. The result is stored in a variable.
3. The tool validates that data was returned.
4. The structured output is returned to the caller.

Structured results

SCALE combines familiar scripting patterns with SQL-like data processing capabilities. This allows data to be filtered and shaped on the endpoint before it is returned.

As a result, tools return structured information rather than raw command output. Because every tool returns data according to a defined return schema, Tia can consistently interpret tool results, reduce ambiguity, and support reliable troubleshooting workflows.

Integration with operating system commands

When required, a SCALE tool can execute operating-system-specific commands internally.

Examples include:

PowerShell commands on Windows

Shell commands on Linux

Shell commands on macOS

Although the underlying commands may differ between operating systems, SCALE ensures that results are returned in a consistent format defined by the tool's return schema.

SCALE and the Tool Catalog

The Tia troubleshooting capabilities article contains the approved diagnostic and remediation tools available to Tia. Tool definitions, expected inputs, outputs, and execution behavior are predefined and governed before they become available. This helps ensure consistency, traceability, and operational control. 

SCALE provides the execution language that powers those tools. Together, SCALE and the Tool Catalog enable controlled and consistent troubleshooting workflows.
 

Governance and control

SCALE provides the execution language used by approved tools, but it does not determine which tools are available. Available tools are governed through the Tool Catalog approval process and execute according to their predefined definitions.

This separation between tool governance and tool execution supports:

• Operational oversight
• Consistent execution
• Traceability
• Controlled automation

By using approved tools and predefined outputs, organizations can maintain greater visibility and control over endpoint automation activities.

Official documentation

For technical reference information about SCALE, see the official SCALE documentation.