メインコンテンツへスキップ
以下のブロックを 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.
このプロンプトはエージェントに対し、ワークスペースで すでに使用されているパッケージマネージャーを尊重する よう指示します。インストール後に npmpnpm の両方のロックファイルができてしまうことはありません。

エージェントが行うこと

  1. お使いのパッケージマネージャー(npm / pnpm / yarn / bun)を検出し、@theplato/tiro-cli をグローバルにインストールします。
  2. tiro --version を実行して、バイナリが PATH 上にあることを確認します。
  3. tiro auth login を実行します。ブラウザが開いて OAuth が始まります。ベアラートークンは OS ネイティブの keychain(Keychain / Secret Service / Credential Manager)に保存されます。
  4. tiro auth statustiro notes list --limit 3 --json を呼び出して、接続を確認します。
ヘッドレス環境では、エージェントはステップ 3 で一時停止し、代わりに TIRO_TOKEN を尋ねます。トークンの発行方法については ヘッドレス、CI、エージェント環境 をご覧ください。

プライバシーとトークンの取り扱い

  • OAuth トークンは OS ネイティブの認証情報ストアに保存されます。完全なベアラートークンが stdout に表示されることはなく、tk__...*** のようなプレフィックスのみが表示されます。
  • TIRO_TOKEN を設定した場合、keychain よりも優先されます。CI シークレットには便利ですが、シェル履歴に漏れると危険です。
  • ローテーションするには、信頼できるマシンで tiro auth logout && tiro auth login を実行し、その後シークレットストアを更新してください。

ご自身でインストールしたい場合は  → 手動でのインストールと認証   ·   クイックスタートのシナリオ   ·   エージェントガイド