インストールと認証

CLI は npm に @theplato/tiro-cli として提供され、macOS、Linux、Windows に対応しています。セキュリティのため、Node.js 22.23.4 以降（22.x）、24.22.1 以降（24.x）、26.12.1 以降（26.x）を推奨します。

1. インストール

セキュリティ上推奨する Node.js は 22.23.4 以降（22.x）、24.22.1 以降（24.x）、26.12.1 以降（26.x）です。この推奨バージョンは、現在の npm パッケージのインストール要件とは別です。インストール前に、現在の Node.js バージョンと npm で公開されている CLI の Node.js 要件を確認してください。

node --version
npm view @theplato/tiro-cli engines

現在の Node.js がセキュリティ上の推奨範囲外、または確認したインストール要件を満たさない場合は、両方を満たす Node.js に更新してから CLI をインストールしてください。

npm install -g @theplato/tiro-cli

pnpm add -g @theplato/tiro-cli

yarn global add @theplato/tiro-cli

bun add -g @theplato/tiro-cli

インストールを確認します:

tiro --version
# → 0.6.4 (or later) — OAuth ログインには 0.6.4 以上が必要です

2. サインイン

tiro auth login

このコマンドは、デフォルトのブラウザで OAuth Authorization Code + PKCE ログインを開始します。CLI はリダイレクトを受け取るため http://127.0.0.1:<random-port>/callback にワンショットのローカルサーバーを開きます。ログイン後、JWT はオペレーティングシステムの認証情報ストアに保管されます。

macOS — Keychain
Linux — Secret Service（gnome-keyring または kwallet が必要）
Windows — Credential Manager

確認します:

tiro auth status
# ✓ Signed in
#   source:     keychain
#   hostname:   https://api.tiro.ooo
#   user:       <userId>
#   expires at: <ISO datetime>
#   token:      tk__...***

画面にはトークンの先頭部分だけが表示されます。完全な Bearer トークンが keychain の外に出ることはありません。

CLI はサインインしたユーザーとして動作します。 そのため読み取り範囲はアプリで見えるノートと同じで、本人の個人フォルダのノートも扱えます。システム API キーはこれとは異なり、全メンバーに共有されたフォルダのノートのみを読み取ります（システムAPIキーが読み取るノートの範囲）。自動化で個人フォルダのノートまで扱う必要がある場合は、CLI かアカウントのAPIキーをご利用ください。

3. サインアウト

tiro auth logout

keychain のエントリをクリアします。次回の tiro auth login では、Tiro の固定 public client で新しい OAuth セッションを開始します。

4. Tiro MCP をエージェントに接続する（任意）

Claude Code（または任意の MCP 互換クライアント）をお使いの場合、CLI は https://mcp.tiro.ooo/mcp でホストされる Tiro MCP 向けのワンライナーインストーラーを提供します:

tiro mcp install
# → claude mcp add --transport http tiro https://mcp.tiro.ooo/mcp

出力をそのままシェルにパイプするか、コマンドを MCP クライアントの設定にコピーしてください。構造化されたビュー（transport、URL、docs リンク）を得るには tiro mcp info --json を実行します。CLI は読み取り中心のフロー（ブラウズ、ディスクへの保存）を担い、MCP はエージェントループ内のインタラクティブなツール呼び出しを担います。完全なエージェントコントラクトについては、パッケージに同梱される AGENTS.md をご覧ください。

ヘッドレス、CI、エージェント環境

ブラウザを開けない環境（CI、SSH、サンドボックス化されたエージェント、Docker）もあります。その場合は TIRO_TOKEN を直接設定してください。ここで指定した値は keychain よりも優先されます。

export TIRO_TOKEN="$(security find-generic-password -s 'io.tiro.cli' -a default -w 2>/dev/null \
  | jq -r '.accessToken')"
tiro notes list --json

GitHub Actions の場合:

- name: Run tiro
  env:
    TIRO_TOKEN: ${{ secrets.TIRO_TOKEN }}
  run: |
    tiro notes search "release notes" --since 1d --json > recent.jsonl

完全なベアラートークンを CI シークレットに格納することは、180 日間有効な Personal Access Token と同等です。ローテーションするには、信頼できるマシンで tiro auth logout && tiro auth login を実行し、新しいトークンをシークレットストアにコピーしてください。

設定のオーバーライド

Variable	用途
`TIRO_TOKEN`	ベアラートークン — keychain を上書き
`TIRO_HOSTNAME`	API ベース URL（デフォルトは `https://api.tiro.ooo`）
`NO_COLOR`	ANSI カラーを無効化（no-color.org）

呼び出しごとのオーバーライド:

tiro --hostname https://api.tiro-ooo.dev notes list      # dev environment
tiro notes get <guid> --json --no-color                  # script-friendly

CLI の更新

npm update -g @theplato/tiro-cli

pnpm update -g @theplato/tiro-cli

yarn global upgrade @theplato/tiro-cli

bun update -g @theplato/tiro-cli

→ 実践的な例については Quickstart へ進んでください。

ホーム

はじめに

API

音声ファイル

Webhook

MCP

CLI

開発者リソース

インストールと認証

1. インストール

2. サインイン

3. サインアウト

4. Tiro MCP をエージェントに接続する（任意）

ヘッドレス、CI、エージェント環境

設定のオーバーライド

CLI の更新

​1. インストール

​2. サインイン

​3. サインアウト

​4. Tiro MCP をエージェントに接続する（任意）

​ヘッドレス、CI、エージェント環境

​設定のオーバーライド

​CLI の更新

1. インストール

2. サインイン

3. サインアウト

4. Tiro MCP をエージェントに接続する（任意）

ヘッドレス、CI、エージェント環境

設定のオーバーライド

CLI の更新