메인 콘텐츠로 건너뛰기
아래 블록을 Claude Code, Cursor의 터미널 에이전트, 또는 셸에 접근할 수 있는 모든 코딩 에이전트에 붙여넣으세요. 에이전트가 npm에서 @theplato/tiro-cli를 설치하고, 브라우저에서 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 lockfile이 둘 다 생기는 일은 없어요.

​
에이전트가 하게 될 일

  1. 패키지 매니저(npm / pnpm / yarn / bun)를 감지하고 @theplato/tiro-cli를 전역 설치해요.
  2. tiro --version을 실행해 바이너리가 PATH에 있는지 확인해요.
  3. tiro auth login을 실행해요. 브라우저가 OAuth를 위해 열려요. bearer token은 OS native keychain(Keychain / Secret Service / Credential Manager)에 저장돼요.
  4. tiro auth status와 tiro notes list --limit 3 --json을 호출해 연결을 증명해요.
headless 환경에서는 에이전트가 3단계에서 멈추고 대신 TIRO_TOKEN을 요청해요. 토큰 발급 방법은 Headless, CI, 에이전트 환경을 참고하세요.

​
개인정보와 토큰 처리

  • OAuth 토큰은 OS native 자격 증명 저장소에 저장돼요. 전체 bearer는 stdout에 절대 나타나지 않고 tk__...*** 같은 prefix만 보여요.
  • TIRO_TOKEN이 설정돼 있으면 keychain을 override해요. CI secret에는 유용하지만 셸 히스토리에 새면 위험해요.
  • 신뢰할 수 있는 머신에서 tiro auth logout && tiro auth login을 실행한 뒤 secret 저장소를 갱신해 rotate하세요.
직접 설치하고 싶으세요?  → 수동 설치 & 인증   ·   Quickstart 시나리오   ·   에이전트 가이드