CLI

Nodaro CLI（@nodaro/cli）は、Nodaro のコマンドラインクライアントです。ワークフローの一覧表示と実行、公開済みアプリの実行、ワークフローなしでの単一ノードの実行ができ、各実行を終了まで追跡します。複数のログイン済みプロファイルを並べて管理でき、スクリプト向けに JSON を出力するので、ターミナルでの作業、cron ジョブ、CI パイプラインに向いています。

CLI は、TypeScript SDK の薄いラッパーです。コードで書く連携には、SDK を直接使ってください。

インストール

npm install -g @nodaro/cli
nodaro --version

npx @nodaro/cli projects list

# 1. The newest CLI version
NODARO_CLI_VERSION=$(curl -fsSL "https://api.github.com/repos/nodaroai/app.nodaro.ai/git/matching-refs/tags/cli-v?per_page=100" \
  | grep -o '"refs/tags/cli-v[0-9][0-9.]*"' | tr -d '"' | sed 's#refs/tags/cli-v##' \
  | sort -t. -k1,1n -k2,2n -k3,3n | tail -n 1)
echo "Installing @nodaro/cli $NODARO_CLI_VERSION"

# 2. Your platform: darwin-arm64 (Apple silicon), darwin-x64 (Intel Mac), linux-x64 or linux-arm64
NODARO_CLI_PLATFORM=darwin-arm64

# 3. Download. -f fails on an HTTP error instead of saving the error page as the binary.
curl -fL "https://github.com/nodaroai/app.nodaro.ai/releases/download/cli-v$NODARO_CLI_VERSION/nodaro-$NODARO_CLI_PLATFORM" \
  -o /usr/local/bin/nodaro && chmod +x /usr/local/bin/nodaro
nodaro --version

$v = (Invoke-RestMethod "https://api.github.com/repos/nodaroai/app.nodaro.ai/git/matching-refs/tags/cli-v?per_page=100") |
  ForEach-Object { $_.ref -replace '^refs/tags/cli-v', '' } |
  Where-Object { $_ -match '^\d+\.\d+\.\d+$' } |
  Sort-Object { [version]$_ } | Select-Object -Last 1
Invoke-WebRequest "https://github.com/nodaroai/app.nodaro.ai/releases/download/cli-v$v/nodaro-windows-x64.exe" -OutFile nodaro.exe
.\nodaro.exe --version

バージョンを固定するには、最初の手順を省略して、自分でバージョンを設定します。CLI のすべてのリリースとそのバイナリは、パブリックリポジトリの cli-v リリースに一覧表示されています。

ログイン

CLI は、個人用 API トークンで認証し、プロファイルに保存します。

ブラウザーでの認証がうまくいかない場合、CLI は代わりにトークンを貼り付けるよう求めます。自分でトークンを作成するには、Nodaro で設定 › APIトークンを開き、トークンを作成をクリックします。トークン全体が表示されるのは 1 回だけです。個人用 API トークンは、Nodaro Cloud と Business エディションの環境で使えます。トークンの仕組みについては、認証を参照してください。

nodaro auth login                                   # browser sign-in
nodaro auth login --no-browser                      # paste a token instead
nodaro auth login --token "$NODARO_TOKEN"           # non-interactive, for CI
nodaro auth status [--profile <name>] [--json]      # show a profile, token masked
nodaro auth logout [--profile <name>]               # delete a saved profile

CLI は、プロファイルを ~/.config/nodaro/config.json に、自分のユーザーだけが読み取れる状態（ファイルモード 0600）で保存します。別のフォルダーに保存するには、NODARO_CONFIG_DIR を設定します。

複数のインスタンスにプロファイルを使う

プロファイルは、保存されたインスタンスのアドレスとトークンです。Nodaro Cloud、ステージング環境、ローカル環境など、インスタンスごとに 1 つのプロファイルを作成します。その後、すべてのコマンドが受け付ける --profile で、使うプロファイルを選びます。

nodaro auth login --profile prod    --base-url https://app.nodaro.ai
nodaro auth login --profile staging --base-url https://staging.example.com
nodaro auth login --profile local   --base-url http://localhost:3000

nodaro projects list --profile staging

--profile を付けないコマンドは、デフォルトのプロファイルを使います。プロファイルを保存するまでのデフォルトは production で、最初に保存したプロファイルがデフォルトになります。そのため、ほとんどの人には、フラグなしの nodaro auth login を 1 回実行するだけで十分です。

ワークスペースを選ぶ

組織機能のあるインスタンスでは、作業はワークスペースの中で行われます。1 つのコマンドだけで選ぶには --workspace <id> を、シェルや CI ジョブで選ぶには NODARO_WORKSPACE を使い、プロファイルに保存するには nodaro workspace use <id> を使います。どれも設定しない場合、作業は個人スペースで行われます。ワークスペースと組織を参照してください。

実行する 3 つの方法

CLI は、Nodaro が作業を実行する 3 つの方法をすべて扱います。作ったものに合う方法を選んでください。

nodaro nodes run は、MCP サーバーの generate_image や generate_video のような、操作を直接実行するツールに相当する CLI コマンドです。生成系のノードはすべて POST /v1/<type> で応答するので、nodaro nodes list に表示されるノードは、どれも nodaro nodes run で実行できます。REST 側については、単一ノードの実行を参照してください。

実行が終わるまで待つには、--watch を付けます。

nodaro nodes run generate-image \
  --param prompt="a snow leopard on a mountain ridge, cinematic" \
  --param provider=flux \
  --watch

--param の書式についてはパラメーターと入力ファイルを、CLI をスクリプト化する前には出力と終了コードを参照してください。

CLI が扱わないもの

CLI は、クレジット、開発者アプリ、OAuth、パイプライン、Reduce、アップロード用のヘルパーを扱いません。これらには、SDK または REST API を使ってください。

CLI からコードへの移行は、すぐに済みます。次は、nodaro workflows run wf_abc に相当する SDK のコードです。

import { createClient, StaticTokenAuth } from "@nodaro/sdk"

const nodaro = createClient({
  baseUrl: "https://app.nodaro.ai",
  auth: new StaticTokenAuth(process.env.NODARO_TOKEN!),
})

const run = await nodaro.workflows.run("wf_abc")

次のステップ