Operate Tier0 with Agents

Tier0 provides a set of skills and CLI commands for agents to operate on it.

Installing Tier0 Skills

Required CLI version: v0.4.6+

Choose the installer that matches your environment.

With Node.js

Use npx when Node.js >= 16 is available to install.

npx @tier0/cli@latest

This runs the full installer and does two things:

• Installs the tier0 CLI binary into ~/.tier0/bin/.
• Installs Cursor/Claude Agent Skills from FREEZONEX/Tier0-skill.

If the Agent Skills registration step fails

If the Agent Skills registration step fails, it does not affect the CLI installation. Run the skills installer manually:

npx skills add FREEZONEX/Tier0-skill

Without Node.js

1. Install the tier0 CLI binary.

curl

curl -fsSL https://raw.githubusercontent.com/FREEZONEX/Tier0-cli/main/install.sh | bash

iwr

iwr https://raw.githubusercontent.com/FREEZONEX/Tier0-cli/main/install.ps1 | iex

2. Install the Agent Skills.

tier0 skills update

What the Tier0 Skill Can Do

The Tier0 Skill gives agents a structured way to choose the right CLI command, read the matching reference, and operate Tier0 through the tier0 CLI.

Setting Operating Instance

Note

SaaS uses https://tier0.dev by default and needs no base URL configuration.

Private deployments must configure the base URL before login. Once it’s configured, all the following commands will be executed on that instance.

tier0 config --base-url https://your-tier0.example.com

Logging In

With an API key

1. Set the API key for the operating instance.

tier0 config --api-key <api-key>

2. Verify the API key identity and permissions.

tier0 auth whoami

3. Perform other operations with the tier0 CLI.

Without an API key

1. Start the browser login.

tier0 login --no-wait --json

2. Go through authentication on the browser by accessing the returned verification_url.
3. Poll for the login result with the returned setup_code.

tier0 login --setup-code <setup_code>

Important

Run config to set the operating instance before configuring an API key or starting browser login; otherwise the CLI may operate on the wrong instance.

Target	Task	Commands
Basic operations	Check CLI and service health	tier0 doctor
Basic operations	Check service connectivity and gateway info	tier0 api /openapi/v1/info --body '{}' --json
Basic operations	Upgrade CLI and skills	tier0 upgrade and tier0 skills update
UNS	Browse paths	tier0 uns browse --path / or tier0 uns browse --path Plant/Line1 --json
UNS	Search for topics by keywords	tier0 uns search --keyword temp --json or tier0 uns search --path-prefix Plant/Line1 --size 50 --json
UNS	Read current values	tier0 uns read Plant/Line1/Metric/Temperature --json or tier0 uns read --topic 'Plant/+/Metric/Temperature' --json
UNS	Write values	tier0 uns write --topic Plant/Line1/Metric/Temperature --value '{"temperature":27.5}'
UNS	Query history	tier0 uns history -t Plant/Line1/Metric/Temperature --start -1h --json
UNS	Create paths or topics	tier0 uns create --topic Plant/Line1 --type path or tier0 uns create --file namespace.json --json
UNS	Update metadata or fields	tier0 uns update --path Plant/Line1/Metric/Temperature --description "Line 1 temperature" --update-mask description
UNS	Delete or restore nodes	tier0 uns delete --path Plant/Line1/Metric/Temperature --yes or tier0 uns restore --path Plant/Line1/Metric/Temperature --yes
Node-RED Flow	List or inspect Flows	tier0 flow list, tier0 flow list --source --json, or tier0 flow get --id 1 --json
Node-RED Flow	Create Source Flow or Event Flow	tier0 flow create --name "modbus-collector" --source --desc "Modbus TCP collector" or tier0 flow create --name "alert-handler" --event --desc "Temperature alarm processor"
Node-RED Flow	Update Flow metadata	tier0 flow update --id 1 --name "line1-collector" or tier0 flow update --id 1 --favorite
Node-RED Flow	Export canvas JSON	tier0 flow data --id 1 --out flows.json
Node-RED Flow	Deploy canvas JSON	tier0 flow deploy --id 1 -f flows.json --yes
Node-RED Flow	Delete Flows	tier0 flow delete --id 1 --yes
Node-RED Flow	Check available node types	tier0 flow nodes --source --json or tier0 flow nodes --event --json

Let an agent read the repo first

For complex UNS or Flow work, ask your agent to read the Tier0 Skill repo before running commands. The repo includes task-specific rules, examples, and safety notes for operations such as batch UNS writes and Node-RED Flow deploys.

Uninstalling Tier0 Skills

# Remove the Tier0 CLI while keeping local configuration.
npx @tier0/cli@latest uninstall

# Remove the Tier0 CLI and delete local configuration, credentials, skills, and cache.
npx @tier0/cli@latest uninstall --purge

Next

• Working with UNS Data - How to operate on your UNS model through MQTT and APIs.