メインコンテンツへスキップ
Tiro CLI は npm に @theplato/tiro-cli として公開されています。MCP サーバーが公開しているのと同じ Tiro API を提供しますが、ファイルシステム中心のワークフロー、シェルパイプライン、そして MCP に到達できないあらゆる環境（CI、cron、アドホックなエージェント実行）に最適化されています。 npm version Node.js

​
クイックインストール

npm install -g @theplato/tiro-cli

tiro auth login                                 # browser opens; OAuth + PKCE
tiro notes search "Q3 Planning" --since 7d --json

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

REST APIMCP serverCLI
対象サービス、インテグレーションMCP 対応の AI クライアントシェル、CI、アドホックなエージェント
結果の到達先自分のコードエージェントの context windowファイルシステム または stdout パイプ
セッションあたりのトークンコストリクエストごと数千（ツールスキーマ）数十（呼び出しごと）
最適な用途サービス間トラフィック小規模な読み取り、マルチターン推論一括エクスポート、ファイル操作、スクリプト
ディスカバリーOpenAPIMCP list_toolstiro --help
3 つのサーフェスは同じ OAuth プロバイダーと JWT オーディエンスを共有するため、いずれか 1 つに発行された認証情報は他のサーフェスでも利用できます。Authentication をご覧ください。
CLI は MCP サーバーの代替ではありません。これは同じデータを別の サーフェスから提供するもので、ファイルシステム中心およびシェルネイティブな ワークフローに最適化されています。会話の中でノートを主に読み取り、推論する Claude Desktop / Cursor / Code エージェントには、引き続き MCP のほうが適しています。 結果をディスクやパイプに出力したい場合は CLI をご利用ください。

​
利用できる機能

  • 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、自動公開。
→ インストールと認証を行うには Setup へ進んでください。

​
リンク