> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tiro.ooo/llms.txt
> Use this file to discover all available pages before exploring further.

# 에이전트에 Tiro CLI 설치하기

> 프롬프트 하나로, 에이전트가 Tiro CLI를 설치하고, 브라우저에서 OAuth를 실행하고, 세션이 살아 있는지 확인해요.

아래 블록을 Claude Code, Cursor의 터미널 에이전트, 또는 셸에 접근할 수 있는 모든 코딩 에이전트에 붙여넣으세요. 에이전트가 npm에서 `@theplato/tiro-cli`를 설치하고, 브라우저에서 OAuth를 실행하고, 세션을 검증해요.

**요구 사항**  ·  Node.js 20+  ·  macOS, Linux, 또는 Windows  ·  에이전트가 명령을 실행할 수 있는 셸

## 이 프롬프트를 복사하세요

```text The Tiro CLI install prompt theme={"system"}
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.
```

<Tip>
  이 프롬프트는 에이전트에게 워크스페이스에서 **이미 사용 중인 패키지 매니저를 존중하라고** 지시해요. 설치 후에 `npm`과 `pnpm` lockfile이 둘 다 생기는 일은 없어요.
</Tip>

## 에이전트가 하게 될 일

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, 에이전트 환경](/ko/developers/cli/setup#headless-ci-and-agent-environments)을 참고하세요.

## 개인정보와 토큰 처리

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

***

직접 설치하고 싶으세요?  → [수동 설치 & 인증](/ko/developers/cli/setup)   ·   [Quickstart 시나리오](/ko/developers/cli/quickstart)   ·   [에이전트 가이드](/ko/developers/cli/agent-guide)