メインコンテンツまでスキップ

CLI インストール

インストール​

npm（推奨）​

npm install -g @nanoterm/cli

pnpm​

pnpm add -g @nanoterm/cli

npx でワンショット実行​

npx @nanoterm/cli ws list

Node 20+ が必要です。

サインイン​

nanoterm auth login

ブラウザを開いてサインインし、このマシン用の CLI API キーを発行して 保存します。保存先は ~/.nanoterm/config.json（パーミッション 0600）。

手動（CI / スクリプト用）​

nanoterm auth set-key nt_your_api_key

ブラウザが使えない環境（CI、ヘッドレスサーバー等）で使用します。 ダッシュボードの API Keys ページでキーを作成してください。

確認​

nanoterm auth status
# Authenticated
#   API:    https://api.nanoterm.dev
#   Key:    nt_a1b2c3d4e5f6...

設定ファイル​

CLI は認証情報を ~/.nanoterm/config.json に保存します：

{
  "apiKey": "nt_..."
}

通常はこれだけで動きます。nanoterm auth login が自動で書き込みます。

任意: 別の API を指定したい場合​

ローカル API（pnpm --filter @nanoterm/api dev）やステージング環境を叩きたいときは URL を上書きします。ホスト版 NanoTerm を使う分には不要です（デフォルトで https://api.nanoterm.dev）。

{
  "apiUrl": "http://localhost:3000",
  "apiKey": "nt_..."
}

環境変数でも可:

export NANOTERM_API_URL=http://localhost:3000

自動アップデート​

CLI は 1 日に 1 回（~/.nanoterm/update-check.json にキャッシュ） npm に新バージョンがあるかを問い合わせ、見つかれば 1 行のお知らせを 表示します。チェックはバックグラウンドで動き、ネットワーク失敗時は サイレント — 実行コマンドをブロックしません。

API が 最低必要バージョンを上げた場合、サーバーから 426 CLI_VERSION_TOO_OLD が返ります（アップグレードコマンド付き）。 以下を実行してリトライしてください:

npm install -g @nanoterm/cli@latest