Tier0 Agent Skills

Tier0 AI Agent skill documentation.

These files are written for agents. Some authentication steps require the user to complete a browser-based authorization flow.

Required CLI version: v0.6.5+

Install CLI and Skills

Recommended one-command install, requires Node.js >= 16:

npx -y @tier0/cli@latest install

This installs:

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

The explicit installer treats Tier0 Skill installation as required. After it finishes, verify authentication:

tier0 auth whoami --json

If authentication is missing, run tier0 login --no-wait --json, show the returned verification_url, and complete the browser flow.

Alternative install without Node.js:

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

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

If using the alternative installer, install skills separately:

npx skills add FREEZONEX/Tier0-skill

Install or Upgrade Enterprise

For a self-hosted Tier0 Enterprise server, read Enterprise installation and upgrades. It covers full offline installation, upgrades of existing deployments, same-version Backend image maintenance, and connecting the CLI after installation.

The CLI installer above and tier0 upgrade update the client, not the Enterprise server. Product upgrades use the scripts and verified manifest shipped with the Enterprise release package.

Configure

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

Private deployments must configure the base URL before login:

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

Important: run config before login; otherwise the authorization URL may point to the wrong instance.

Login

Preferred when an API key is already available:

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

Browser authorization flow:

tier0 login --no-wait --json

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

tier0 login --setup-code <setup_code>

Verify

tier0 doctor
tier0 auth whoami
tier0 api /openapi/v1/info --body '{}'

Safe Write Previews

Tier0 Skills use --dry-run --json to validate generated UNS and Flow mutation requests before execution. Dry-run output contains the HTTP method, URL, and body, but never credentials and never sends the request.

High-risk delete, restore, and deploy workflows preview first, ask for user confirmation, and only then execute with --yes.

Uninstall

npx @tier0/cli@latest uninstall
npx @tier0/cli@latest uninstall --purge

Directory

• SKILL.md - Main routing and safety rules
• installation/enterprise.md - Enterprise installation, upgrades, and Backend image maintenance
• uns/ - UNS data-plane operations
• mqtt/ - MQTT credentials, publish, and continuous subscriptions
• flow/ - Node-RED Flow management and user-defined HTTP endpoints
• launchpad/ - Project member, role, and application queries
• platform/ - Platform member, Workspace role, and user status queries
• info/ - Service information and connectivity checks
• auth/ - API key identity diagnostics