Build AKARI Apps. MCP サーバー 1 本で、あなたのアプリを AKARI に繋げる。
Connect your app to AKARI OS — the AI-native overlay OS for individual creators. Your App gets access to the shared memory layer, agent runtime, and Shell UI that every official AKARI app uses. No special privileges. Same SDK, same contract.
# 1. 雛形を生成する / Scaffold a new App
npx @akari-os/app-cli create my-app --tier mcp-declarative
# 2. ローカルで起動 / Start local dev server
cd my-app
pnpm install
pnpm dev
# 3. Lint + Contract Test を実行 / Run certification checks
pnpm certify迷ったら MCP-Declarative から。 MCP サーバー 1 本 +
panel.schema.jsonだけで Shell に パネルが出ます。準備ができたら Full Tier に昇格できます。
| Tier | 一言 | 向いている用途 |
|---|---|---|
| MCP-Declarative | 手軽。MCP サーバー + 宣言的 UI だけで完結 | 既存 API の AKARI 統合、X/Notion 連携など |
| Full | 自由度最大。React Panel + Agent + Skill を自前実装 | Writer / Video 相当の本格 App |
迷ったら MCP-Declarative で始めてください。Full への昇格は後からできますが、逆方向はできません。
AKARI App SDK を通じて、あなたの App は以下にアクセスできます：
| API | できること |
|---|---|
| Memory API | Pool（素材倉庫）と AMP（エージェント記憶）を読み書きする |
| Agent API | App 固有のエージェントを定義・呼び出す |
| UI API | AKARI Shell にパネルを mount する |
| Inter-App API | Writer / Video など公式 App との handoff |
| Permission API | 権限ゲート / Human-in-the-Loop |
| Context API | ACE でコンテキストを組み立てる |
| Skill API | 他 App から呼び出せる関数を公開する |
- Getting Started — 最初の App を動かす
- Tier Comparison — Full vs MCP-Declarative
- API Reference — 7 API 群のリファレンス
- Certification Guide — マーケット掲載のための品質ゲート
- Cookbook — 典型ユースケースのレシピ集
- Examples — 動くコードのリファレンス実装
packages/
├── sdk/ @akari-os/sdk — 7 API 群のコアライブラリ
├── app-cli/ @akari-os/app-cli — 雛形生成・開発・配布ツール
├── panel-schema/ @akari-os/panel-schema — MCP-Declarative の宣言的 UI スキーマ
└── cert/ @akari-os/cert — Certification (Lint / Contract Test)
examples/
├── x-sender/ X (Twitter) への投稿 — MCP-Declarative の最小構成
├── notion/ Notion 連携 — 既存 API を AKARI に載せる典型パターン
└── writer-plus/ Writer の拡張 — Full Tier リファレンス
貢献は大歓迎です。CONTRIBUTING.md をご覧ください。
- バグ報告・機能要望: Issues
- コードの貢献: Pull Request を送ってください
- ドキュメントの改善: 誤字・リンク切れ修正は PR 直接どうぞ
MIT © 2026 Ryoma Nakajima
AKARI は「ツール」ではない。個人クリエイター専用の、エッジで動く AI OS。 あなたが作る App は、そのエコシステムの一部になる。