otakit

OtaKit

Capacitor アプリ向けの、完全なオープンソースでセルフホスト可能な無線アップデートフレームワークです。アプリストアの審査を受けずに、Capacitor アプリへ直接アップデートをリリースできます。

無料でお試しください：OtaKit.app

セルフホスティング

OtaKit はホスティングサービスを優先して提供しています。 otakit.app のマネージドサービスがすべてを管理しますが、プラットフォーム全体がこのリポジトリに含まれており、独自のインフラストラクチャ上でも実行できます。最小構成は、コンソール（標準的な Next.js アプリ）、Postgres、CDN の背後にある S3 互換バケットです。

手順をすべて解説したガイド：otakit.app/docs/self-host

仕組み

1. ダッシュボードでアプリを作成します。
2. appId を capacitor.config.* にコピーします。
3. アプリのウェブアセットをビルドします。
4. otakit upload --release を実行して、バンドルをアップロードし、リリースを公開します。
5. サーバーがバンドルとマニフェストを CDN の背後にあるオブジェクトストレージに書き込みます。
6. 次回のアプリ起動時または再開時に、プラグインが CDN からマニフェストを取得して現在のバンドルと比較し、新しいバージョンがあればダウンロードします。
7. タイムアウトまでに notifyAppReady() が呼び出されると、新しいバンドルが確定されます。それ以外の場合、プラグインは前のバンドルに自動でロールバックします。

MCP とエージェントスキル

Claude Code、Codex、または VS Code にアップデートの公開を依頼すると、Capacitor プロジェクトを読み取り、変更を無線で安全に配信できるか確認し、ビルドをアップロードします。さらに、デバイスに反映される前に承認を求めます。

プロジェクトディレクトリで次のコマンドを 1 つ実行します。

npx -y @otakit/cli@latest connect

クライアントを検出し、必要に応じてサインインしてから、解決されたコンソール、組織、プロジェクト、アプリと、書き込む正確なファイルを表示してから書き込みます。--dry-run を指定すると、計画を表示するだけで、何も書き込みません。

Claude Code には、サーバーと OtaKit Agent Skill をまとめて提供するプラグインがあります。

npx -y @otakit/cli@latest login

claude plugin marketplace add OtaKit/otakit
claude plugin install otakit@otakit

Codex、Claude Code、リモート OAuth、権限、ワークフロー、セルフホスティングについては、MCP とエージェントスキルのガイドをご覧ください。

基本概念

• アプリ — appId で識別される Capacitor アプリです
• バンドル — バージョン、ハッシュ、サイズを含む、アップロード済みのウェブビルドの zip ファイルです
• リリース — バンドルをチャンネルに昇格させ、CDN にマニフェストを公開するものです
• チャンネル — staging などの任意のリリーストラックです
• ランタイムバージョン — プラグインで設定する、任意のネイティブ互換性レーンです

パッケージ

• packages/capacitor-plugin — モバイルアプリ内で動作するランタイム
• packages/cli — バンドルのアップロードとリリースの作成に使う CLI
• packages/mcp-core — MCP コントラクト、ツールカタログ、サーバー登録の共有実装
• packages/site — 公開サイト、ドキュメント、お問い合わせ、法務関連ページ
• packages/console — ダッシュボード、API、認証、課金、Prisma スキーマ
• packages/ingest — デバイスイベントを取り込む Cloudflare Worker
• tinybird/ — イベント分析用の Tinybird データソースとパイプ

packages/
  capacitor-plugin/   Capacitor OTA plugin
  cli/                Upload + release CLI
  mcp-core/           Shared MCP contracts and tool catalog
  ingest/             Cloudflare Worker event ingest service
  site/               Next.js public site + docs
  console/            Next.js dashboard + API + auth + billing
tinybird/             Tinybird event analytics project
examples/
  demo-app/           Demo Capacitor app wired to the local plugin

パッケージのドキュメント

• packages/capacitor-plugin/README.md
• packages/cli/README.md
• packages/ingest/README.md
• packages/site/README.md
• packages/console/README.md
• tinybird/README.md

ローカル開発

• Node.js 20.9+、pnpm 9+
• コンソールアプリ（packages/console）には Postgres と R2 互換ストレージが必要です。packages/console/.env.example をご覧ください。
• デバイスイベント分析には、任意で取り込みサービス（packages/ingest）と Tinybird ワークスペースが必要です。
• セットアップの詳細については、各パッケージの README をご覧ください。

pnpm install
pnpm dev        # starts the console app in dev mode

ライセンス

MIT