Skip to main content
Paste the prompt below into any coding agent that can run shell commands. It installs the CLI, signs you in with OAuth, and checks the connection. Requirements  ·  Node.js 20+  ·  macOS, Linux, or Windows  ·  a shell the agent can run commands in

Copy this prompt

The Tiro CLI install prompt
The prompt tells the agent to use the package manager your project already uses.

What your agent will do

  1. Detect your package manager (npm / pnpm / yarn / bun) and install @theplato/tiro-cli globally.
  2. Verify the binary is on PATH by running tiro --version.
  3. Run tiro auth login — your browser opens for OAuth. The bearer token is stored in the OS-native keychain (Keychain / Secret Service / Credential Manager).
  4. Confirm the connection with tiro auth status and tiro notes list --limit 3 --json.
In a headless environment, the agent pauses on step 3 and asks you for a TIRO_TOKEN instead — see Headless, CI, and agent environments for how to mint one.

Privacy & token handling

  • OAuth tokens are stored in the OS-native credential store. The full bearer never appears on stdout — only a prefix like tk__...***.
  • TIRO_TOKEN, if set, overrides the keychain — useful for CI secrets, dangerous if it leaks into shell history.
  • Rotate by running tiro auth logout && tiro auth login on a trusted machine, then update the secret store.

Prefer to install it yourself?  → Manual install & auth   ·   Quickstart scenarios   ·   Agent guide