> ## 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. # CLI 概要 > Tiro の AI ノート・トランスクリプト向けの、エージェントファーストなコマンドライン。 Tiro CLI は npm に [`@theplato/tiro-cli`](https://www.npmjs.com/package/@theplato/tiro-cli) として公開されています。MCP サーバーが公開しているのと同じ Tiro API を提供しますが、ファイルシステム中心のワークフロー、シェルパイプライン、そして MCP に到達できないあらゆる環境（CI、cron、アドホックなエージェント実行）に最適化されています。 [![npm version](https://img.shields.io/npm/v/@theplato/tiro-cli)](https://www.npmjs.com/package/@theplato/tiro-cli) [![Node.js](https://img.shields.io/node/v/@theplato/tiro-cli)](https://nodejs.org) ## クイックインストール ```bash npm theme={"system"} npm install -g @theplato/tiro-cli ``` ```bash pnpm theme={"system"} pnpm add -g @theplato/tiro-cli ``` ```bash yarn theme={"system"} yarn global add @theplato/tiro-cli ``` ```bash bun theme={"system"} bun add -g @theplato/tiro-cli ``` ```bash theme={"system"} tiro auth login # browser opens; OAuth + PKCE tiro notes search "Q3 Planning" --since 7d --json ``` ## どのサーフェスをいつ使うか | | **REST API** | **MCP server** | **CLI** | | ---------------- | -------------- | -------------------------- | --------------------------- | | 対象 | サービス、インテグレーション | MCP 対応の AI クライアント | シェル、CI、アドホックなエージェント | | 結果の到達先 | 自分のコード | エージェントの **context window** | **ファイルシステム** または stdout パイプ | | セッションあたりのトークンコスト | リクエストごと | 数千（ツールスキーマ） | 数十（呼び出しごと） | | 最適な用途 | サービス間トラフィック | 小規模な読み取り、マルチターン推論 | 一括エクスポート、ファイル操作、スクリプト | | ディスカバリー | OpenAPI | MCP `list_tools` | `tiro --help` | 3 つのサーフェスは同じ OAuth プロバイダーと JWT オーディエンスを共有するため、いずれか 1 つに発行された認証情報は他のサーフェスでも利用できます。[Authentication](/ja/developers/fundamentals/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 ` で特定のワークスペースを指定できます。有料・オプトインで、MCP の wiki ツールをミラーします。 * **MCP 形式の JSON**: `tiro notes transcript --format json` は MCP の `get_note_transcript` ペイロードを完全にミラーします。既存の MCP パーサーをそのまま再利用できます。 * **ファイル出力**: すべての取得コマンドは `--output ` をサポートしており、実際のコンテンツはディスクに出力され、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](/ja/developers/cli/setup) へ進んでください。 ## リンク * npm: [npmjs.com/package/@theplato/tiro-cli](https://www.npmjs.com/package/@theplato/tiro-cli) * GitHub: [github.com/plato-corp/tiro-cli](https://github.com/plato-corp/tiro-cli) * Changelog: [CHANGELOG.md](https://github.com/plato-corp/tiro-cli/blob/main/CHANGELOG.md) * Issues: [github.com/plato-corp/tiro-cli/issues](https://github.com/plato-corp/tiro-cli/issues)