CLI コマンドリファレンス

グローバルフラグこれらのフラグは任意の tier0 コマンドで使用できます。

--json生の JSON を出力--debugHTTP リクエスト/レスポンス詳細を出力

基本操作

tier0 doctorローカル Tier0 CLI の接続と認証を診断

使用方法

tier0 doctor

注記

• ローカル設定、OpenAPI 接続、API key の有無、API key の識別情報を確認します。

例

tier0 doctor

tier0 config設定を表示または更新

使用方法

tier0 config

フラグ

--base-url

プラットフォームの base URL を設定

--api-key

API key を設定（tier0 login の代替）

--lang

非推奨の互換フラグ。CLI 出力は英語のみです非推奨

例

tier0 config

tier0 config --base-url https://tier0.dev

tier0 config --api-key sk-per-xxxxxx

tier0 loginDevice Flow で認証

使用方法

tier0 login

フラグ

--no-wait

認証 URL を出力し、ポーリングせずに終了

--setup-code

新規作成せず既存の setup code をポーリング

--base-url

プラットフォームの base URL を上書き

注記

• --no-wait を指定しない場合、CLI は最大 10 分間、5 秒ごとにポーリングします。
• --no-wait --json を指定すると、CLI は verification_url、setup_code、expires_in を返します。

例

tier0 login

tier0 login --no-wait --json

tier0 login --setup-code <setup_code>

tier0 apiAPI endpoint を直接呼び出す

使用方法

tier0 api <endpoint>

フラグ

--body

リクエストボディの JSON 文字列

--body-file

ファイルからリクエストボディを読み込む

--method

HTTP メソッド（GET|POST|PUT|DELETE）デフォルト: POST

--dry-run

実行せずにリクエストをプレビュー

注記

• --body と --body-file は同時に指定できません。

例

tier0 api /openapi/v1/uns/browse --body '{"path":"/"}'

tier0 api /openapi/v1/uns/read --body '{"topics":["demo"]}'

tier0 api /openapi/v1/uns/write --body-file body.json

tier0 upgradeCLI を最新バージョンにアップグレード

使用方法

tier0 upgrade

フラグ

--dry-run

インストールせず更新を確認

-v, --version

指定バージョンへアップグレード（デフォルト: latest）

例

tier0 upgrade

tier0 upgrade --dry-run

tier0 uninstalltier0 CLI をアンインストール

使用方法

tier0 uninstall

フラグ

--purge

設定ファイル（認証情報）も削除

--remove-skills

検出された AI agents から Tier0 Skill も削除

--keep-skills

agent skills を保持（非推奨。現在はこれがデフォルトです）非推奨

注記

• Agent Skills と設定はデフォルトで保持されます。
• CLI のアンインストール時に、ローカルの内蔵 skills ディレクトリは削除されます。

例

tier0 uninstall

tier0 uninstall --purge

tier0 uninstall --remove-skills

tier0 uninstall --purge --remove-skills

tier0 versionバージョンを表示

使用方法

tier0 version

例

tier0 version

スキル

tier0 skills installCLI に内蔵された Skill をインストールまたは修復

使用方法

tier0 skills install

フラグ

--force

有効な Skill を内蔵ベースラインで置き換える

--no-sync

検出された AI agents に同期せず、ローカルのみにインストール

例

tier0 skills install

tier0 skills install --force

tier0 skills listインストール済み skills を一覧表示エイリアス: ls

使用方法

tier0 skills list

例

tier0 skills list

tier0 skills updateskills を最新バージョンに更新エイリアス: upgrade

使用方法

tier0 skills update

フラグ

--dry-run

インストールせず更新を確認

例

tier0 skills update

tier0 skills update --dry-run

tier0 skills versionskills のバージョン情報を表示エイリアス: ver

使用方法

tier0 skills version

例

tier0 skills version

tier0 skills status有効な Skill と内蔵 Skill の状態を表示

使用方法

tier0 skills status

例

tier0 skills status

tier0 skills sync有効な Skill を検出された AI agents に同期

使用方法

tier0 skills sync

例

tier0 skills sync

認証

tier0 auth whoami現在の API key の識別情報を表示

使用方法

tier0 auth whoami

注記

• ユーザー、workspace、key 名、key タイプ、ロール、権限を表示します。

例

tier0 auth whoami

tier0 auth whoami --json

UNS

tier0 uns browseUNS namespace ツリーを参照

使用方法

tier0 uns browse

フラグ

-p, --path

UNS ツリーで参照するパスデフォルト: /

-d, --max-depth

最大再帰深度（0 = 無制限）デフォルト: 1

--include-metadata

ノードメタデータを含める

--include-leaf-value

リーフノードの値を含める

例

tier0 uns browse

tier0 uns browse --path /devices

tier0 uns browse --path / --max-depth 2

tier0 uns searchUNS topics を検索

使用方法

tier0 uns search

フラグ

-k, --keyword

名前キーワードで検索

--path-prefix

パス接頭辞でフィルタデフォルト: /

--topic-type

topic type でフィルタ

--page

ページ番号デフォルト: 1

-l, --size

ページサイズ（最大件数）デフォルト: 20

--include-metadata

ノードメタデータを含める

--include-leaf-value

リーフノードの値を含める

例

tier0 uns search --keyword temp

tier0 uns search --path-prefix /devices --size 50

tier0 uns search --keyword temp --include-metadata

tier0 uns readUNS topics の現在値を読み取る

使用方法

tier0 uns read [topic...]

tier0 uns read --topic <topic>

フラグ

-t, --topic

読み取る topic 名（繰り返し可。位置引数も使用できます）繰り返し可

--include-metadata

topic メタデータ（topicType、fields、description）を含める

--include-leaf-value

リーフノードの値を含める

注記

• 位置引数または --topic で少なくとも 1 つの topic が必要です。

例

tier0 uns read demo

tier0 uns read --topic demo

tier0 uns read temp humidity

tier0 uns read --topic sensor1 --include-metadata

tier0 uns writeUNS topic に値を書き込む

使用方法

tier0 uns write

フラグ

-t, --topic

書き込み先 topic 名（必須）必須

-v, --value

JSON 値文字列（--file と同時指定不可）

-f, --file

ファイルから値を読み込む（--value と同時指定不可）

--qos

MQTT QoS レベル（0/1/2）デフォルト: 0

--retain

MQTT retain フラグを設定

--dry-run

実行せずにリクエストをプレビュー

注記

• --value と --file は同時に指定できません。
• 値は topic fields に一致する有効な JSON object である必要があります。

例

tier0 uns write --topic demo --value '{"temp":25}'

tier0 uns write --topic demo --file payload.json

tier0 uns write --topic sensor1 --value '{"on":true}' --qos 1 --retain

tier0 uns historytopics の履歴データを照会

使用方法

tier0 uns history

フラグ

-t, --topic

topic 名（繰り返し可、必須）必須繰り返し可

--start

開始時刻: 相対指定（-1h/-30m/-7d）、ISO 8601、または 'now'（必須）必須

--end

終了時刻: 相対指定、ISO 8601、または 'now'（デフォルト: now）デフォルト: now

--page

ページ番号デフォルト: 1

-l, --size

ページサイズ（最大データポイント数）デフォルト: 100

--interval

集計間隔（例: 1m、1h、1d）

--fn

集計関数（avg/max/min/sum/count）

--field

集計フィールド名

例

tier0 uns history -t demo --start -1h

tier0 uns history -t demo --start -24h --end now --fn avg --interval 1h

tier0 uns history -t demo --start 2026-01-01T00:00:00Z --end 2026-01-02T00:00:00Z

tier0 uns createUNS namespace ノードを作成

使用方法

tier0 uns create

フラグ

-t, --topic

topic パスまたはリーフ名（--file を使用しない場合は必須）

--parent

親パス接頭辞（任意。--topic と組み合わせます）

--type

ノードタイプ: 'path'（フォルダー）または 'topic'（データポイント）

-d, --display-name

表示名

--description

説明

--alias

エイリアス

-f, --file

JSON ファイルから namespace 定義を読み込む（{"namespace":[]} または配列のみ）

--topic-type

非推奨: topic type は現在、パス（リーフ直前の Metric/Action/State フォルダー）から推定されます非推奨

--fields

schema fields の JSON 配列

--fields-file

ファイルから schema fields の JSON 配列を読み込む

--dry-run

実行せずにリクエストをプレビュー

注記

• --file を使用しない場合、--topic と --type が必要です。
• --fields と --fields-file は同時に指定できません。
• topic ノードでは、リーフ直前のパス要素が Metric、Action、または State である必要があります。

例

tier0 uns create --topic Plant/Line1/Metric/Temperature --type topic

tier0 uns create --parent Factory1/Line1/Station1 --topic Metric/ProductionCount --type topic

tier0 uns create --topic Plant/Line1 --type path --display-name 'Line 1'

tier0 uns create --file namespace.json

tier0 uns updateUNS topic のメタデータを更新

使用方法

tier0 uns update

フラグ

-p, --path

更新する topic パス（必須）必須

-n, --name

新しい名前

--alias

新しいエイリアス

--description

新しい説明

--clear-description

空の shell 引数に依存せず説明をクリアする

-d, --display-name

新しい表示名

--extend-properties

拡張プロパティ JSON object

--fields

schema fields の JSON 配列

--fields-file

ファイルから schema fields の JSON 配列を読み込む

--update-mask

更新するフィールド（繰り返し可。例: name、description、fields）繰り返し可

--dry-run

実行せずにリクエストをプレビュー

注記

• --description と --clear-description は同時に指定できません。
• --fields と --fields-file は同時に指定できません。
• 更新するフィールドを少なくとも 1 つ指定する必要があります。

例

tier0 uns update --path Plant/Line1/Metric/Temperature --display-name 'Line 1 Temp'

tier0 uns update --path Plant/Line1 --description 'Production line 1' --update-mask description

tier0 uns update --path Plant/Line1/Metric/Temperature --fields '[{"name":"temp","type":"float","unit":"C"}]' --update-mask fields

tier0 uns deleteUNS ノードを削除

使用方法

tier0 uns delete

フラグ

-p, --path

削除するノードパス（繰り返し可、必須）必須繰り返し可

--hard

ハード削除（元に戻せません）

-y, --yes

高リスク操作を確認（必須）必須

--dry-run

実行せずにリクエストをプレビュー

注記

• デフォルトはソフト削除で、復元できます。
• --hard は元に戻せません。
• --dry-run を使用しない限り、高リスク操作には --yes が必要です。

例

tier0 uns delete --path factory/line1/sensor/temp --yes

tier0 uns delete --path factory/line1/sensor/temp --path factory/line1/sensor/humi --yes

tier0 uns delete --path factory/line1/sensor/temp --hard --yes

tier0 uns restore履歴から topic を復元

使用方法

tier0 uns restore

フラグ

-p, --path

復元する topic パス（必須）必須

-y, --yes

高リスク操作を確認（必須）必須

--dry-run

実行せずにリクエストをプレビュー

注記

• --dry-run を使用しない限り、高リスク操作には --yes が必要です。

例

tier0 uns restore --path Plant/Line1/Metric/Temperature --yes

Node-RED フロー

tier0 flow listflows を一覧表示エイリアス: ls

使用方法

tier0 flow list

フラグ

-k, --keyword

名前キーワードでフィルタ

-t, --type

タイプでフィルタ（SourceFlow/EventFlow）

--source

SourceFlow のみ表示

--event

EventFlow のみ表示

注記

• --source と --event は同時に指定できません。
• --type は --source または --event と同時に指定できません。

例

tier0 flow list

tier0 flow list --source --json

tier0 flow getflow の詳細を取得

使用方法

tier0 flow get --id <id>

tier0 flow get <id>

フラグ

--id

Flow IDデフォルト: 0

注記

• --id または位置引数で正の Flow ID を指定する必要があります。

例

tier0 flow get --id 1 --json

tier0 flow get 1 --json

tier0 flow create新しい flow を作成

使用方法

tier0 flow create

フラグ

-n, --name

Flow 名（必須）必須

-t, --type

Flow タイプ: SourceFlow | EventFlow（必須）必須

--source

タイプを SourceFlow に設定

--event

タイプを EventFlow に設定

--desc

説明

--template

初期テンプレート JSON 文字列

--template-file

ファイルから初期テンプレートを読み込む

--dry-run

実行せずにリクエストをプレビュー

注記

• Flow タイプの選択には --type、--source、--event のいずれか 1 つだけを使用してください。
• --template と --template-file は同時に指定できません。

例

tier0 flow create --name "modbus-collector" --source --desc "Modbus TCP collector"

tier0 flow create --name "alert-handler" --event --desc "Temperature alarm processor"

tier0 flow updateflow メタデータを更新

使用方法

tier0 flow update --id <id>

tier0 flow update <id>

フラグ

--id

Flow ID（必須）デフォルト: 0

-n, --name

新しい名前

--desc

新しい説明

--template

新しいテンプレート JSON 文字列

--template-file

ファイルから新しいテンプレートを読み込む

--favorite

お気に入りに追加

--unfavorite

お気に入りから削除

--dry-run

実行せずにリクエストをプレビュー

注記

• --id または位置引数で正の Flow ID を指定する必要があります。
• --template と --template-file は同時に指定できません。
• --favorite と --unfavorite は同時に指定できません。
• 更新するフィールドを少なくとも 1 つ指定する必要があります。

例

tier0 flow update --id 1 --name "line1-collector"

tier0 flow update --id 1 --favorite

tier0 flow dataNode-RED canvas JSON を取得

使用方法

tier0 flow data --id <id>

tier0 flow data <id>

フラグ

--id

Flow IDデフォルト: 0

-o, --out

出力をファイルに保存

注記

• --id または位置引数で正の Flow ID を指定する必要があります。

例

tier0 flow data --id 1 --out flows.json

tier0 flow deployNode-RED canvas JSON をデプロイ

使用方法

tier0 flow deploy --id <id>

tier0 flow deploy <id>

フラグ

--id

Flow ID（必須）デフォルト: 0

--flows-json

Node-RED canvas JSON 文字列

-f, --flows-file

ファイルから Node-RED canvas JSON を読み込む（推奨）

-y, --yes

高リスク操作を確認（必須）必須

--dry-run

実行せずにリクエストをプレビュー

注記

• --id または位置引数で正の Flow ID を指定する必要があります。
• --flows-json と --flows-file は同時に指定できません。
• デプロイすると、この Flow 内の既存の Node-RED ノードがすべて置き換えられます。
• --dry-run を使用しない限り、高リスク操作には --yes が必要です。

例

tier0 flow deploy --id 1 -f flows.json --dry-run --json

tier0 flow deploy --id 1 -f flows.json --yes

tier0 flow deleteflow を削除エイリアス: del, rm

使用方法

tier0 flow delete --id <id>

tier0 flow delete <id>[,<id>...]

フラグ

--id

削除する Flow ID（繰り返し可）繰り返し可

-y, --yes

高リスク操作を確認（必須）必須

--dry-run

実行せずにリクエストをプレビュー

注記

• 位置引数にはカンマ区切りの Flow ID を含められます。
• 削除すると Node-RED コンテナーが停止し、元に戻せません。
• --dry-run を使用しない限り、高リスク操作には --yes が必要です。

例

tier0 flow delete --id 1 --yes

tier0 flow nodes利用可能な Node-RED ノードタイプを一覧表示

使用方法

tier0 flow nodes [source|event]

tier0 flow nodes --type <SourceFlow|EventFlow>

tier0 flow nodes --source

tier0 flow nodes --event

フラグ

-t, --type

Flow タイプ（SourceFlow/EventFlow）

--source

SourceFlow ノードを表示

--event

EventFlow ノードを表示

注記

• 位置引数の Flow タイプは最大 1 つまで指定できます。
• --source と --event は同時に指定できません。
• 位置引数/タイプ入力を --source または --event と併用しないでください。

例

tier0 flow nodes source --json

tier0 flow nodes --source --json

tier0 flow nodes --event --json

ファイル

tier0 assets uploadTier0 object storage にファイルをアップロード

使用方法

tier0 assets upload <local-file>

フラグ

--business

業務シーンデフォルト: attachment

--use-by

使用範囲: user|workspace|platformデフォルト: workspace

--visibility

可視性: public|privateデフォルト: private

--app-instance-id

AI アプリインスタンス ID

--session-id

AI セッション ID

--multipart-size

マルチパートのパートサイズ（例: 10MB、最小 5MB）デフォルト: CLI-defined default

--concurrency

マルチパートアップロードの同時実行数（並列パート数）デフォルト: 4

--resume

中断されたマルチパートアップロードを再開

--abort

中断されたマルチパートアップロードを中止し、状態をクリーンアップ

注記

• ローカルファイル引数を 1 つだけ指定する必要があります。
• 100MB を超えるファイルは自動的にマルチパートアップロードを使用します。
• CLI は厳密な最大ファイルサイズを強制しません。サーバー側でプラン/クォータ制限が適用されます。

例

tier0 assets upload ./report.csv

tier0 assets upload ./report.csv --visibility public --business attachment

tier0 assets upload ./report.csv --use-by workspace --visibility private

tier0 assets upload ./large-backup.tar.gz

tier0 assets upload ./large-backup.tar.gz --resume

tier0 assets upload ./large-backup.tar.gz --abort

tier0 assets upload ./large-backup.tar.gz --multipart-size 20MB --concurrency 8

tier0 assets downloadTier0 object storage からファイルをダウンロード

使用方法

tier0 assets download

フラグ

--file-path

アップロードで返されたファイルパス必須

-o, --output

出力ファイルパス（デフォルト: stdout）

--content-disposition

カスタム Content-Disposition

例

tier0 assets download --file-path workspace/.../report.csv -o ./report.csv

tier0 assets download --file-path workspace/.../report.csv

tier0 assets urlTier0 object storage のファイルアクセス URL を取得

使用方法

tier0 assets url

フラグ

--file-path

アップロードで返されたファイルパス必須

--expired-sec

署名付き URL の有効期限（秒）デフォルト: 3600

--content-disposition

カスタム Content-Disposition

例

tier0 assets url --file-path workspace/.../report.csv

tier0 assets url --file-path workspace/.../report.csv --expired-sec 300

tier0 assets deleteTier0 object storage のファイルを削除

使用方法

tier0 assets delete

フラグ

--file-path

アップロードで返されたファイルパス必須

-y, --yes

高リスク操作を確認（必須）必須

--dry-run

実行せずにリクエストをプレビュー

注記

• 削除は元に戻せません。
• --dry-run を使用しない限り、高リスク操作には --yes が必要です。

例

tier0 assets delete --file-path workspace/.../report.csv --dry-run --json

tier0 assets delete --file-path workspace/.../report.csv --yes