インストールと認証

CLI は npm に @theplato/tiro-cli として提供され、Node.js 20+ で動作します。macOS、Linux、Windows に対応しています。

1. インストール

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.3.1 (or later)

システム要件: Node.js 20 以降。同梱されるバイナリは ESM 専用です。Node 18 では import 時にエラーになります。

2. サインイン

tiro auth login

これにより、デフォルトのブラウザで Tiro の OAuth Authorization Code + PKCE フローが開きます。CLI は http://127.0.0.1:<random-port>/callback でワンショットのローカル HTTP サーバーを起動し、リダイレクトを受け取ります。サインインすると、JWT は OS ネイティブの認証情報ストアに保存されます:

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__...***

表示されるのはトークンのプレフィックスのみです。完全なベアラートークンが keychain の外に出ることはありません。

3. サインアウト

tiro auth logout

keychain のエントリと、キャッシュされた Dynamic Client Registration ID をクリアします。次回の tiro auth login では、新しい DCR クライアントが登録されます。

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`）
`TIRO_OUTPUT_DIR`	export コマンドのデフォルト `--output-dir`（v0.3+）
`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 へ進んでください。

​1. インストール

​2. サインイン

​3. サインアウト

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

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

​設定のオーバーライド

​CLI の更新

1. インストール

2. サインイン

3. サインアウト

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

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

設定のオーバーライド

CLI の更新