CLI 개요

​

빠른 설치

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 auth login                                 # browser opens; OAuth + PKCE
tiro notes search "Q3 Planning" --since 7d --json

​

어떤 방식을 쓸까요

​

무엇을 얻나요

• 인증: tiro auth login | status | logout — OAuth Authorization Code + PKCE로 로그인하고 토큰을 운영체제의 자격 증명 저장소에 보관해요.
• 노트: tiro notes list | search | get | transcript — MCP의 list_notes / search_notes / get_note / get_note_transcript와 같은 데이터를 다뤄요.
• 위키: tiro wiki workspaces | search | page | mentions | graph — 위키를 검색하고 읽어요. --workspace <guid>로 워크스페이스를 지정할 수 있어요. 유료이며 별도로 활성화해야 해요.
• MCP 형식 JSON: tiro notes transcript --format json은 MCP get_note_transcript와 같은 응답을 반환해요. 기존 MCP 파서를 재사용할 수 있어요.
• 파일 출력: 모든 조회 명령은 --output <path>를 지원해요. 콘텐츠는 파일에 저장하고 stdout에는 메타데이터 한 줄만 남겨요.
• 에러 형식: 모든 에러는 문서화된 종료 코드와 { ok: false, error: { code, message, suggestion?, errorType?, httpStatus?, requestId? } }를 반환해요.

​

아키텍처

                       Tiro Backend — /v1/external/* + /v1/mcp/*
                              │
       ┌──────────────────────┼──────────────────────┐
       ▼                      ▼                      ▼
  ┌──────────┐         ┌──────────────┐       ┌──────────────┐
  │ REST     │         │ MCP server   │       │ CLI          │
  │ clients  │         │ (uniform     │       │ (filesystem, │
  │          │         │  shape)      │       │  bulk, pipe) │
  └──────────┘         └──────────────┘       └──────────────┘

​

링크

• npm: npmjs.com/package/@theplato/tiro-cli
• GitHub: github.com/plato-corp/tiro-cli
• Changelog: CHANGELOG.md
• Issues: github.com/plato-corp/tiro-cli/issues