diff --git a/README.ja.md b/README.ja.md
new file mode 100644
index 00000000..d719f695
--- /dev/null
+++ b/README.ja.md
@@ -0,0 +1,147 @@
+MiMoCode
+
+
+ 
+
+
+セッションをまたぐメモリを備えたオープンソースの AI コーディングエージェント。
+
+
+ 中文 | English | 日本語
+
+
+
+ ウェブサイト | ブログ
+
+
+---
+
+MiMoCode はターミナルネイティブな AI コーディングアシスタントです。コードの読み書き、コマンドの実行、Git の管理ができ、永続的なメモリシステムを使ってセッションをまたいでプロジェクトを深く理解し続けながら、自身を継続的に改善していきます。
+
+MiMo Auto が期間限定無料のチャネルとして組み込まれているため、設定なしで始められます。MiMoCode は主要な LLM プロバイダー API への接続にも対応しています。
+
+---
+
+## クイックスタート
+
+```bash
+# ワンラインインストール
+curl -fsSL https://mimo.xiaomi.com/install | bash
+
+# または npm 経由でインストール
+npm install -g @mimo-ai/cli
+```
+
+初回起動時には設定が自動的にガイドされます。対応しているオプションは以下のとおりです。
+- **MiMo Auto（期間限定無料）** — 匿名チャネル、設定不要
+- **Xiaomi MiMo Platform** — OAuth ログイン
+- **Claude Code からのインポート** — 既存の認証情報をワンステップで移行
+- **カスタムプロバイダー** — OpenAI 互換 API を TUI 上で追加
+
+---
+
+## 主な機能
+
+### 複数のエージェント
+
+| エージェント | 説明 |
+|--------|------|
+| **build** | デフォルト。開発向けにすべてのツール権限を持つ |
+| **plan** | コード探索や解決策の設計のための読み取り専用分析モード |
+| **compose** | 仕様駆動開発やスキル駆動ワークフローのためのオーケストレーションモード |
+
+`Tab` キーでプライマリエージェントを切り替えられます。サブエージェントは必要に応じてシステムが作成します。
+
+### 永続的なメモリ
+
+SQLite FTS5 の全文検索によるセッションをまたぐメモリ。
+
+- **プロジェクトメモリ**（`MEMORY.md`）— 永続的なプロジェクトの知識、ルール、アーキテクチャ上の意思決定
+- **セッションチェックポイント**（`checkpoint.md`）— checkpoint-writer サブエージェントが自動的に維持する構造化された状態スナップショット
+- **スクラッチノート**（`notes.md`）— エージェント用の一時的なメモ領域
+- **タスク進捗**（`tasks//progress.md`）— タスクごとのログ
+
+セッション再開時にメモリが自動的に注入されるため、エージェントはプロジェクトのコンテキストを再学習する必要がありません。
+
+### インテリジェントなコンテキスト管理
+
+- **自動チェックポイント** — モデルのコンテキストウィンドウに基づいてセッション状態を保存するタイミングを判断
+- **コンテキスト再構築** — コンテキストが上限に近づくと、最新のチェックポイント、プロジェクトメモリ、タスク進捗、保持された直近のメッセージから再構築し、エージェントが現在のタスクを継続できるようにする
+- **予算付き注入** — トークン予算を使って、チェックポイント・メモリ・ノートの内容がどれだけコンテキストに入るかを重要度ランキングとともに制御
+
+### タスクトラッキング
+
+ツリー状のタスクシステム（`T1`、`T1.1`、`T1.2` …）がチェックポイントシステムと自動的に統合され、セッション再開時にもタスク進捗が保持されます。
+
+### サブエージェントシステム
+
+プライマリエージェントは必要に応じてサブエージェントを作成できます。サブエージェントは現在のセッションコンテキストを共有し、並列で動作できるほか、ライフサイクルの追跡、キャンセル、バックグラウンド実行に対応しています。
+
+### ゴール / 停止条件
+
+`/goal` コマンドでセッションの停止条件を設定します。エージェントが停止しようとすると、独立したジャッジモデルが会話を評価し、条件が本当に満たされているかを判断します。これにより、自律作業中の早すぎる「楽観的な停止」を防ぎます。
+
+### Compose モード
+
+Compose モードは仕様駆動開発のための構造化されたワークフローを提供します。計画、実行、コードレビュー、TDD、デバッグ、検証、マージのための組み込みスキルを備え、仕様から出荷されるコードまでのライフサイクル全体をオーケストレーションします。
+
+### 音声入力
+
+TenVAD と MiMo ASR を活用したリアルタイムストリーミング音声入力。`/voice` で起動して話すと、音声は間（ポーズ）で区切られ、逐次的に文字起こしされて入力に反映されます。MiMo にログインしているユーザーが利用できます。
+
+### Dream & Distill
+
+- **`/dream`** — 直近のセッショントレースをスキャンし、永続的な知識をプロジェクトメモリに抽出し、古くなったエントリを削除する
+- **`/distill`** — 直近の作業から繰り返される手動ワークフローを発見し、信頼度の高い候補を再利用可能なスキル、サブエージェント、コマンドにパッケージ化する
+
+---
+
+## 設定
+
+MiMoCode はプロジェクトディレクトリ内の `.mimocode/mimocode.json`（またはグローバルな `~/.config/mimocode/mimocode.json`）で設定します。主なオプションは以下のとおりです。
+
+- プロバイダーとモデルの選択
+- エージェントの権限とカスタムエージェント
+- チェックポイントとメモリの挙動
+- MCP サーバー接続
+- キーバインドとテーマ
+
+Max Mode（ジャッジ選択による並列 best-of-N 推論）は、設定の `experimental.maxMode` で有効化できます。
+
+---
+
+## 開発
+
+```bash
+bun install # 依存関係をインストール
+bun run dev # 開発モードで実行
+bun turbo typecheck # 型チェック
+```
+
+---
+
+## OpenCode との関係
+
+MiMoCode は [OpenCode](https://github.com/anomalyco/opencode) のフォークとして構築されています。OpenCode のすべてのコア機能（複数プロバイダー、TUI、LSP、MCP、プラグイン）を維持しつつ、永続的なメモリ、インテリジェントなコンテキスト管理、サブエージェントのオーケストレーション、ゴール駆動の自律ループ、compose ワークフロー、dream/distill による自己改善を追加しています。
+
+---
+
+## コミュニティ
+
+QR コードをスキャンしてコミュニティのグループチャットに参加できます。
+
+
+ 
+
+ 
+
+
+---
+
+## ライセンス
+
+ソースコードは [MIT ライセンス](./LICENSE) の下でライセンスされています。
+
+MiMoCode の使用は [使用制限](./USE_RESTRICTIONS.md) にも従うものとします。
+Xiaomi MiMo がホストするサービスの使用は [MiMo 利用規約](https://platform.xiaomimimo.com/docs/terms/user-agreement) に従います。
+MiMo の名称、ロゴ、商標の使用は MiMo 商標ポリシーに従います。
diff --git a/README.md b/README.md
index fc276fdc..8834ad1f 100644
--- a/README.md
+++ b/README.md
@@ -7,7 +7,7 @@
An open-source AI coding agent with cross-session memory.
- 中文 | English
+ 中文 | English | 日本語
diff --git a/README.zh.md b/README.zh.md
index dd67ba43..29734b18 100644
--- a/README.zh.md
+++ b/README.zh.md
@@ -7,7 +7,7 @@
开源 AI 编程智能体，拥有跨会话记忆。
- 中文 | English
+ 中文 | English | 日本語