CLI は npm に @theplato/tiro-cli として提供され、Node.js 20+ で動作します。macOS、Linux、Windows に対応しています。
1. インストール
npm install -g @theplato/tiro-cli
tiro --version
# → 0.3.1 (or later)
システム要件: Node.js 20 以降。同梱されるバイナリは ESM 専用です。Node 18 では import 時にエラーになります。
2. サインイン
これにより、デフォルトのブラウザで 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__...***
3. サインアウト
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
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
- 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
