설치와 인증

CLI는 npm에 @theplato/tiro-cli로 배포되고 Node.js 20+에서 동작해요. macOS, Linux, Windows를 지원해요.

1. 설치

npm install -g @theplato/tiro-cli

pnpm add -g @theplato/tiro-cli

yarn global add @theplato/tiro-cli

bun add -g @theplato/tiro-cli

설치를 확인하세요:

tiro --version
# → 0.3.1 (or later)

시스템 요구 사항: Node.js 20 이상. 배포되는 바이너리는 ESM 전용이라 Node 18은 import에서 에러가 나요.

2. 로그인

tiro auth login

이 명령은 기본 브라우저에서 OAuth Authorization Code + PKCE 로그인을 시작해요. CLI는 redirect를 받으려고 http://127.0.0.1:<random-port>/callback에서 일회용 로컬 서버를 열어요. 로그인한 뒤 JWT는 운영체제의 자격 증명 저장소에 보관돼요.

macOS — Keychain
Linux — Secret Service (gnome-keyring 또는 kwallet 필요)
Windows — Credential Manager

확인하세요:

tiro auth status
# ✓ Signed in
#   source:     keychain
#   hostname:   https://api.tiro.ooo
#   user:       <userId>
#   expires at: <ISO datetime>
#   token:      tk__...***

화면에는 토큰 앞부분만 표시돼요. 전체 Bearer 토큰은 keychain 밖으로 노출되지 않아요.

CLI는 로그인한 사용자로 동작해요. 그래서 조회 범위가 앱에서 보는 노트와 같고, 본인의 개인 폴더 노트도 다룰 수 있어요. 시스템 API 키는 이와 달라서 전체 구성원에게 공유된 폴더의 노트만 조회해요(시스템 키가 조회하는 노트 범위). 자동화가 개인 폴더 노트까지 다뤄야 한다면 CLI나 사용자 키를 쓰세요.

3. 로그아웃

tiro auth logout

keychain 항목과 캐시된 Dynamic Client Registration ID를 지워요. 다음 tiro auth login은 새 DCR client를 등록해요.

4. 에이전트에 Tiro MCP 연결하기 (선택)

Claude Code(또는 MCP 호환 클라이언트)를 쓴다면, CLI는 https://mcp.tiro.ooo/mcp에 호스팅된 Tiro MCP를 위한 한 줄짜리 installer를 제공해요:

tiro mcp install
# → claude mcp add --transport http tiro https://mcp.tiro.ooo/mcp

출력을 셸로 바로 파이핑하거나, 명령을 MCP 클라이언트의 config에 복사하세요. 구조화된 뷰(transport, URL, docs link)를 보려면 tiro mcp info --json을 실행하세요. CLI는 읽기 위주 플로(브라우징, 디스크 저장)를 다루고, MCP는 에이전트 루프 안의 인터랙티브한 tool 호출을 다뤄요. 전체 에이전트 계약은 패키지에 동봉된 AGENTS.md를 참고하세요.

Headless, CI, 에이전트 환경

일부 환경은 브라우저를 열 수 없어요(CI, SSH, sandbox 에이전트, Docker). 그런 경우엔 TIRO_TOKEN을 직접 설정하세요. 여기 들어가는 값은 keychain을 override해요.

export TIRO_TOKEN="$(security find-generic-password -s 'io.tiro.cli' -a default -w 2>/dev/null \
  | jq -r '.accessToken')"
tiro notes list --json

GitHub Actions에서:

- name: Run tiro
  env:
    TIRO_TOKEN: ${{ secrets.TIRO_TOKEN }}
  run: |
    tiro notes search "release notes" --since 1d --json > recent.jsonl

전체 bearer token을 CI secret에 넣는 것은 180일짜리 Personal Access Token과 같아요. 신뢰할 수 있는 머신에서 tiro auth logout && tiro auth login을 실행하고 새 토큰을 secret 저장소에 복사해 rotate하세요.

설정 override

Variable	용도
`TIRO_TOKEN`	Bearer token — keychain을 override
`TIRO_HOSTNAME`	API base URL (기본값 `https://api.tiro.ooo`)
`TIRO_OUTPUT_DIR`	export 명령의 기본 `--output-dir` (v0.3+)
`NO_COLOR`	ANSI 색상 비활성화 (no-color.org)

호출별 override:

tiro --hostname https://api.tiro-ooo.dev notes list      # dev environment
tiro notes get <guid> --json --no-color                  # script-friendly

CLI 업데이트

npm update -g @theplato/tiro-cli

pnpm update -g @theplato/tiro-cli

yarn global upgrade @theplato/tiro-cli

bun update -g @theplato/tiro-cli

→ 직접 해보는 예제를 보려면 Quickstart로 이어가세요.

홈

시작하기

API

웹훅

MCP

CLI

개발자 리소스

1. 설치

2. 로그인

3. 로그아웃

4. 에이전트에 Tiro MCP 연결하기 (선택)

Headless, CI, 에이전트 환경

설정 override

CLI 업데이트

​1. 설치

​2. 로그인

​3. 로그아웃

​4. 에이전트에 Tiro MCP 연결하기 (선택)

​Headless, CI, 에이전트 환경

​설정 override

​CLI 업데이트

1. 설치

2. 로그인

3. 로그아웃

4. 에이전트에 Tiro MCP 연결하기 (선택)

Headless, CI, 에이전트 환경

설정 override

CLI 업데이트