tier0

name	tier0
description	Tier0 platform operations entry point: CLI setup, authentication, routing to UNS, Flow, service info, and API key diagnostics skills.
metadata	{"requires":{"bins":["tier0"]},"cliHelp":"tier0 --help"}

Tier0

This is the shared entry point for Tier0 CLI work. Keep this file focused on setup, authentication, and routing. Task-specific behavior belongs in the matching sub skill or reference file.

Use When

Use this skill when the user asks about:

• installing or configuring Tier0 CLI
• authenticating with Tier0
• choosing the right Tier0 skill or command family
• UNS, Flow, Node-RED, service connectivity, or API key permissions

Setup

Recommended install:

npx @tier0/cli@latest

Alternative install:

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

If using the alternative installer, install skills separately:

npx skills add FREEZONEX/Tier0-skill

Configuration

SaaS uses https://tier0.dev by default.

Private deployments must be configured before login:

tier0 config --base-url <tier0-base-url>

If base-url changes, run login again or set an API key for that instance. Existing keys are tied to the previous instance and Workspace.

Authentication

Preferred when an API key is already available:

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

Browser device flow:

tier0 login --no-wait --json

Show the returned verification_url to the user. Then poll with:

tier0 login --setup-code <setup_code>

The polling command blocks until browser authorization completes or times out.

Routing

Read the target sub skill or reference before executing a task-specific command.

User goal	Read
Browse, search, read, write, history, create, update, delete, or restore UNS nodes/topics	uns/SKILL.md
List, inspect, create, update, delete, export, or deploy Node-RED Flows	flow/SKILL.md
Check service connectivity and gateway info	info/info.md
Check API key identity and permissions	auth/whoami.md

Core Concepts

Concept	Meaning
Workspace	Tenant boundary for all resources
UNS	Unified Namespace, a tree of paths and data topics
Path	Folder-like namespace segment
Topic	Full leaf path, such as Plant/Line1/Metric/Temperature
Flow	Node-RED instance managed by Tier0

Flow names and UNS paths are often manually kept similar, but current APIs do not expose a guaranteed relation field. When the user asks about a named device or data point, check both UNS and Flow unless they explicitly ask for only one side.

Shell Notes

Quote wildcard topics in shells that expand *, +, or #:

tier0 uns read --topic 'Plant/+/Metric/Temperature'

For complex JSON, prefer files or stdin over fragile shell quoting.

Updates

The CLI checks for updates in the background at most once every 24 hours. Upgrade manually with:

tier0 upgrade
tier0 skills update