クイックスタート：道を 1 つ選び、5 分で動かす

tansr はエージェントランタイムです。同じ 1 つのカーネル（クエリループ、ツールスケジューリング、権限エンジン、コンテキスト圧縮）を、いくつかの異なる形態で提供します。すべてを理解する必要はありません。「エージェントをどこで動かしたいか」に合わせて道を 1 つ選ぶだけです。

まず 1 つ答える：エージェントはどこで動く？

あなたの状況	おすすめの入口	対応する記事
ターミナルで直接エージェントと対話し、コードを直し、スクリプトを実行したい	`tansr` CLI	CLI を 5 分で動かす
Node.js / Electron プログラムを書いていて、エージェントを自分のプロセスに組み込みたい	`@tansr/sdk`	Node SDK を 5 分で動かす
自分のモバイル / Web ユーザーにエージェントを提供したい。マルチユーザーのバックエンドが必要	`@tansr/serve` セルフホストのセッションサービス	セッションサービスを 5 分で動かす
Android アプリを書いていて、バックエンドは `@tansr/serve` を使う（予定）	Kotlin SDK `com.tansr.sdk`	Android と iOS を 5 分で動かす
iOS / macOS アプリを書いていて、バックエンドは上と同じ	Swift パッケージ `tansr-ios`	同じ記事の「iOS でも同じ手順」節

経験則は 2 つです。

自分ひとりで使うなら CLI、他人に使わせるなら SDK かセッションサービス。 CLI は開発者本人のためのもの、SDK とセッションサービスはあなたのプロダクトのユーザーのためのものです。
モバイルは必ずあなた自身のサーバーを経由する。 Android / iOS SDK は薄いプロトコルクライアントで、プラットフォームの認証情報を一切持ちません。エージェントのカーネルは、あなたがデプロイした @tansr/serve の中で動きます。

どの道を選んでも、認証情報は 3 層に分かれ、下に行くほど外に漏らしてはいけません。

個人アクセストークン（PAT）：コンソールで作成し、tansr init でローカルの CLI にログインするためだけに使います。あなた本人を表します。
アプリキー（appid / appkey）：コンソールで 1 つの「アプリ」に対して発行します。appkey はあなたのサーバー側（Node プロセスまたは @tansr/serve）にしか置けず、エンドユーザー向けの短期トークンを発行するために使います。appkey は端末デバイスに配布しない、ログに書かない、リポジトリに入れない。
短期 app_user トークン：あなたのサーバーが appkey で発行し、端末（Electron のメインプロセス、または @tansr/serve 内部）に渡します。期限が来れば失効し、漏洩しても影響範囲は TTL で抑えられます。

CLI ユーザーに必要なのは第 1 層だけです。SDK とセッションサービスの開発者には第 2・3 層が必要です。置き場所とローテーションの詳細はセキュリティとプライバシーを参照してください。

4 本の形態別記事（Android と iOS は 1 本にまとめています）は同じ順序で展開するので、形態間で対照しやすくなっています。

前提：実行環境とバージョン要件（Node ≥ 22.19 が共通のベースライン）。
インストール：npm i -g @tansr/cli、npm install @tansr/sdk、npm install @tansr/serve、または Maven / SwiftPM の座標。
認証情報：その形態にどの層の認証情報が必要で、どこから取得するか。
最初のセッション：動く最短のコード。
イベントを見る：エージェントの出力はすべてイベントストリーム（msg.text.delta、tool.completed など）です。このステップで自分の目で確認します。
次のステップ：対応する詳細ガイドへの案内。

形態	最低要件
CLI（npm パッケージ）	Node.js ≥ 22.19。Windows / macOS / Linux。単一ファイル実行版はランタイムを同梱しており Node 不要
`@tansr/sdk`	Node.js ≥ 22.19。Electron ≥ 39。ESM only。TypeScript target ≥ ES2022
`@tansr/serve`	Node.js ≥ 22.19。サードパーティのランタイム依存は `zod` のみ
Android SDK	minSdk 26。Kotlin コルーチン + kotlinx.serialization + OkHttp
iOS SDK	iOS 16+ / macOS 13+。SwiftPM

知りたいこと	行き先
セッションをどう永続化し、切断後にどう復旧するか	チェックポイントと再開（SDK）· v2 プロトコルと webhook（セッションサービス）
プラットフォームが自分のアプリにどんな機能を配布しているか、コンソールでどう切り替えるか	プラットフォームアセンブリとバンドル
あるエラーコードの意味、再試行できるか	エラー処理と再試行 · エラーコード表
サーバーのデプロイ、グレースフルシャットダウン、複数レプリカでのシャーディング	デプロイと認証
セッションはいつまで保持され、いつ回収されるか	保持期間とガバナンス
CLI の設定ファイルはどこか、`tansr doctor` の出力をどう読むか	設定と doctor
データはどこに保存されるか、キーをどうローテーションするか、通信はどこへ向かうか	セキュリティとプライバシー