以下のブロックを Claude Code、Cursor のターミナルエージェント、またはシェルアクセスを持つ任意のコーディングエージェントに貼り付けてください。エージェントが @theplato/tiro-cli を npm からインストールし、ブラウザで OAuth を実行して、セッションを検証します。
要件 · Node.js 20+ · macOS、Linux、または Windows · エージェントがコマンドを実行できるシェル
このプロンプトをコピー
The Tiro CLI install prompt
Install the Tiro CLI in this environment and sign me in.
Package : @theplato/tiro-cli (Node.js 20+)
Platforms : macOS, Linux, Windows
Auth : OAuth (Authorization Code + PKCE) — opens a browser
and stores the token in the OS keychain.
Steps:
1. Install globally with whichever package manager is already in
use here. For npm, that is:
npm install -g @theplato/tiro-cli
(Use pnpm / yarn / bun equivalents if those are the active
package manager — do not switch tooling.)
2. Verify the install:
tiro --version # expect 0.3.1 or later
3. Sign me in:
tiro auth login # opens a browser for OAuth
4. Confirm the session:
tiro auth status # shows user + token prefix only
If this is a headless / CI / sandboxed environment without a browser,
do not run `tiro auth login`. Instead, ask me for a TIRO_TOKEN value
and export it for subsequent commands:
export TIRO_TOKEN="<paste-token-here>"
When everything is connected, run:
tiro notes list --limit 3 --json
and show me the output to prove the CLI is working. If any step
fails, show the exact command, the exit code, and the error — do
not retry silently.
このプロンプトはエージェントに対し、ワークスペースで すでに使用されているパッケージマネージャーを尊重する よう指示します。インストール後に npm と pnpm の両方のロックファイルができてしまうことはありません。
エージェントが行うこと
- お使いのパッケージマネージャー(npm / pnpm / yarn / bun)を検出し、
@theplato/tiro-cli をグローバルにインストールします。
tiro --version を実行して、バイナリが PATH 上にあることを確認します。
tiro auth login を実行します。ブラウザが開いて OAuth が始まります。ベアラートークンは OS ネイティブの keychain(Keychain / Secret Service / Credential Manager)に保存されます。
tiro auth status と tiro notes list --limit 3 --json を呼び出して、接続を確認します。
ヘッドレス環境では、エージェントはステップ 3 で一時停止し、代わりに TIRO_TOKEN を尋ねます。トークンの発行方法については ヘッドレス、CI、エージェント環境 をご覧ください。
プライバシーとトークンの取り扱い
- OAuth トークンは OS ネイティブの認証情報ストアに保存されます。完全なベアラートークンが stdout に表示されることはなく、
tk__...*** のようなプレフィックスのみが表示されます。
TIRO_TOKEN を設定した場合、keychain よりも優先されます。CI シークレットには便利ですが、シェル履歴に漏れると危険です。
- ローテーションするには、信頼できるマシンで
tiro auth logout && tiro auth login を実行し、その後シークレットストアを更新してください。
ご自身でインストールしたい場合は → 手動でのインストールと認証 · クイックスタートのシナリオ · エージェントガイド