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

​

どのサーフェスをいつ使うか

​

利用できる機能

• Auth: tiro auth login | status | logout — ループバックリダイレクトを用いた OAuth Authorization Code + PKCE。トークンは OS Keychain に保存されます。
• Notes: tiro notes list | search | get | transcript — MCP の list_notes / search_notes / get_note / get_note_transcript と同じサーフェスをカバーします。
• Wiki: tiro wiki workspaces | search | page | mentions | graph — 自動抽出されたナレッジグラフを読み取ります。--workspace <guid> で特定のワークスペースを指定できます。有料・オプトインで、MCP の wiki ツールをミラーします。
• MCP 形式の JSON: tiro notes transcript --format json は MCP の get_note_transcript ペイロードを完全にミラーします。既存の MCP パーサーをそのまま再利用できます。
• ファイル出力: すべての取得コマンドは --output <path> をサポートしており、実際のコンテンツはディスクに出力され、stdout はメタデータの 1 行に縮小されます。エージェントの context window を軽く保つうえで重要です。
• 安定したエラーエンベロープ: すべてのエラーは { 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) │
  └──────────┘         └──────────────┘       └──────────────┘

​

ロードマップ

• ✅ 0.1 — auth（login / status / logout）と --help。
• ✅ 0.2 — notes コア（list / search / get / transcript）に加え、MCP 形式の transcript JSON、パース済みの例、最初のテストスイート。
• ✅ 0.3 — パッケージの整備（ホワイトリスト公開、sourcemap の除去）、tiro mcp info / tiro mcp install、AGENTS.md の同梱、段落単位の transcript タイムスタンプと --no-timestamps、刷新された OAuth コールバックページ。
• ⏳ 0.4 — notes export（一括 → ディレクトリ + マニフェスト）、テンプレート、共有リンク、フォルダ、tiro schema による自己記述。
• ⏳ 1.0 — 安定版。パブリックライセンス、Homebrew tap、自動公開。

​

リンク

• 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