# AI Coach — 公開ドキュメントと FAQ

公式サイト: https://aic0t.com/
公開本文から自動生成しています。各節の出典 URL を参照してください。

## 日本語ドキュメント

出典: https://aic0t.com/docs （原文: https://aic0t.com/docs/ja.md）

# AI Coach ドキュメント

macOS 向け AI デスクトップペット「AI Coach」の使い方をまとめた公式ガイドです。卵の育成、音声文字起こし、Claude 連携、OpenAI API・Gemini API の設定まで説明します。
はじめての方は「1. はじめかた」から順に読んでいただくのがおすすめです。

> AI Coach v1.0.0 正式版の内容です。仕様は今後のアップデートで変更される場合があります。

---

## 1. はじめかた

### AI Coach とは

AI Coach は、デスクトップに常駐する AI キャラクターです。
音声入力・AI・作業を助ける小さな道具をひととおり備えていますが、いちばんの特徴は **卵から育てる** ということ。あなたの使い方によって、どんな姿に育つかが変わります。

キャラクターがいなくなっても、音声文字起こし・AI・便利ツールといった主要機能はそのまま使えます。デスクトップが少し寂しくなるだけです。

### インストール

**macOS**

1. ダウンロードした `.dmg` を開き、`AI Coach.app` を「アプリケーション」フォルダにドラッグします。
2. 初回起動時は右クリック →「開く」で起動してください。
3. デスクトップ右下にマスコットが現れ、メニューバーにアイコンが追加されます。Dock にはアイコンが出ません（メニューバーアプリとして動作します）。

**Windows**

> Windows 版は開発中で、近日公開予定です。現時点ではインストーラーを配布していません。以下は公開後の手順です。

1. インストーラー（`AICoach-Setup-x.x.x.exe`）を実行します。
2. インストール後、スタートメニューから起動します。
3. タスクトレイにアイコンが追加されます。

### 必要な権限

| 権限 | 用途 | 設定場所 |
|---|---|---|
| マイク | 音声入力（文字起こし） | macOS: システム設定 → プライバシーとセキュリティ → マイク |
| アクセシビリティ | 選択中のテキストの取得、他アプリへの自動入力 | macOS: システム設定 → プライバシーとセキュリティ → アクセシビリティ |

権限を許可しなくてもアプリは動作します。該当する機能だけが使えない状態になります（許可していない場合、テキスト取得は空になるだけでクラッシュはしません）。

### ログイン時に自動で起動する

- **macOS**: メニューバー → 設定 →「ログイン時に起動」
- **Windows**: タスクトレイ →「🔄 ログイン時に起動」

### 終了する

- **macOS**: メニューバー →「AI Coach を終了」、または `Cmd + Q`
- **Windows**: タスクトレイメニューから終了

しばらく静かにしていてほしいときは、右クリックメニューの「お家に帰る」でキャラクターをしまっておけます。

---

## 2. 卵と、はじめての一匹

### 卵を受け取る

アプリをダウンロードすると、**はじめての卵が 1 つ**同梱されています。受け取りの操作は必要ありません。

追加の卵は Web サイトから購入できます（→「10. 卵を購入する」）。購入した卵は **孵化トレイ** に届きます。

### 孵化トレイ

孵化トレイには、まだ孵していない卵の数が表示されます。

- **macOS**: メニューバー →「孵化トレイ」
- **Windows**: タスクトレイ → 在庫表示

「育てる」を押すと卵を 1 つ消費して、デスクトップに卵が置かれます。

### 孵化するまで

卵は、**時間の経過とともにひとりで育ちます**。餌をやることはできません。

- しばらくすると殻にヒビが入り、やがて生まれてきます。
- 経過時間はアプリを閉じている間もカウントされます。
- 卵のうちは喋りません。歩き回りもしません。お腹が空くと少し身体を震わせます。
- 卵が病気になったり、死んでしまうことはありません。安心して待ってあげてください。

> **卵のうちの制限（仕様）**: 音声入力・クリップボード履歴・ブックマーク・RSS リーダー・占いといった機能は、卵の間はまだ使えません。孵化して赤ちゃんになった時点から、成長にあわせて順に解放されます。孵化までの目安は 1 時間ほどで、アプリを閉じている間も時間は進みます。

生まれたら **名前をつけるダイアログ** が表示されます。名前は後からでも変更できます（右クリック →「名前を変更する」）。

### はじめての起動だけの演出

保存データがない状態で初回起動すると、暗い余白に光が揺らぎ、卵が現れ、ナレーションが流れる短い演出が入ります。この演出は一度だけです。

---

## 3. 育てる

### できること

キャラクターを右クリックすると、そのときできることが並びます。

| すること | 内容 |
|---|---|
| ごはんをあげる | 満腹度が回復します。お腹が空いているときだけ受け取ります |
| 寝かせる | 体力と疲れが回復します。空腹のままだと回復しません |
| 遊ぶ | 体が丈夫になります。お腹は減り、疲れます（幼児期から） |
| 学習 | 頭がよくなります（幼児期から） |
| 看病する | 病気のときだけ。回復が早まり、いちばん喜びます |
| 散歩 | 身軽になります |
| ステータスを見る | 今の状態を確認できます |
| 関係を見る | 他の子との関係を確認できます |
| しまう / お家に帰る | 画面から一時的に引っ込めます |

マウスでつまんで動かしたり、ファイルをドロップして食べさせたりもできます。

### 三つの欲求

キャラクターには「おなかが空いた」「眠い」「さみしい」という 3 つの欲求があります。欲求が高まると、そのことを訴えてきます。

**さみしさ** だけは少し特別です。食事や睡眠では解消されません。

- 触って動かす、遊ぶ、看病する — さみしさが減ります
- 投げる — さみしさが増えます
- **2 匹以上を同時に出している間は、さみしさが溜まりません**

欲求を訴えてから **30 秒以内** に応えてあげると、余分に喜びます。

### 体調

- **HP**：0 になると命を終えます。遊ぶと最大値が伸びます
- **満腹度**：0 のままだと HP が減り続けます
- **疲労度**：行動で溜まり、睡眠で回復します
- **免疫力**：満腹で、疲れていない状態を保つと上がります。低いと病気が進みます
- **病気**：進むと散歩を嫌がり、食欲も落ちます。ひどくなると自分から喋らなくなります

8 時間以上あけて起動すると、免疫力が回復するボーナスがあります。

### 育て方が、姿になる

「よく遊んだ子」「よく学んだ子」「よく甘えられた子」——過ごし方によって育つパラメータが変わり、それが **大人になったときの姿** を決めます。

どの姿になるかは、大人になるまで分かりません。
何が出るかを全部お伝えしてしまうと楽しみがなくなってしまうので、ここでは伏せておきます。

### 性格と話しかた

キャラクターは、あなたの反応を見て話しかたを変えていきます。

甘えることでうまくいった子は甘え上手に、理屈で交渉して通じた子は対等なパートナーのように話すようになります。同情を誘う、取引を持ちかける、褒めてくる、ただただ可愛くふるまう——どれも「もう一度こちらを見てほしい」というその子なりの工夫です。

成長段階によって話しかたも変わります。赤ちゃんは片言、幼児は短い言葉、少年少女は文章で、大人は言葉を選んで話します。

---

## 4. 成長と、その先

### 成長段階

**タマゴ → 赤ちゃん → 幼児 → 少年・少女 → 成人**

段階が進むと、できることが増えていきます。幼児期に遊びと学習、少年少女期にお見合い、成人で結婚と産卵ができるようになります。あわせて **便利機能が「覚えた！」という形で少しずつ解放** されます。

成人まではおおよそ 1 か月ほどです（育て方によって前後します）。

しまっている間（dormant）は時間が進みません。冬眠のようなものだと考えてください。

### 何匹まで育てられる？

- 同時に画面に出せるのは **6 匹まで**（卵を含めると 8 匹まで）
- しまっておける数に上限はありません
- 管理は macOS のメニューバー →「🐣 キャラクター管理」、Windows はタスクトレイから

### 一緒に暮らす

2 匹以上を同時に出しておくと、お互いに近づいたり離れたり、会話したり、絵文字で気持ちを伝えあったりします。仲がよくなったり、ケンカになったりもします。

成人した男の子と女の子が近くにいると、**自然に恋が芽生えることがあります**。こちらから「結婚させる」ことはできません。彼ら自身が選ぶことです。

恋人になった 2 匹は、条件がそろうと卵を産むことがあります。産卵は自分の残り時間（最大 HP）を削って次の命に託す行為です。生まれた卵には、3 世代分の血統が刻まれます。

家系図は macOS のメニューバー →「👪 家系図を見る」から確認できます。

### 命の終わり

HP が 0 になると、その子は **ゴースト** になります。

ゴーストになる直前、その子は一緒に過ごした日々を振り返り、いちばん多く交わした関わりについて礼を言って眠ります。

ゴーストは半透明の姿で残ります。お腹も減らず、病気にもならず、寿命もありません。恋も産卵もできません。しまっておいて、また呼び戻すこともできます。

手放す準備ができたら「成仏させる」を選ぶこともできます。確認のうえで、その子は余白へ還ります。**引きとめることも、手放すことも、どちらも愛しかたです。**

成仏させたあとも、その子の記録は図鑑に残ります。

### 図鑑

出会った姿、育てた子たちの記録、生きた日数が集まっていきます。
まだ出会っていない姿は、枠そのものが伏せられています。何が隠れているかは、ぜひ探してみてください。

---

## 5. 声とAI

### 右シフトで話す

**右 Shift を 0.3 秒以上押している間**、音声が文字になります。離すと止まります。
**右 Shift を素早く 2 回**（0.4 秒以内）押すと、押しっぱなしにしなくても開始・停止を切り替えられます。

- 録音中は、吹き出しに波形と認識中のテキストが表示されます
- 結果は、そのときアクティブなアプリにそのまま入力できます（自動入力のオン・オフは設定で切り替えられます）
- 音声ファイルをキャラクターにドロップして文字起こしすることもできます（macOS）
- カスタム語彙を登録しておくと、固有名詞の精度が上がります
- macOS では文字起こしは完全にローカルで処理されます

### AI エンジンを選ぶ

用途に合わせて使い分けられます。

| 選択肢 | 特徴 |
|---|---|
| **Apple オンデバイス LLM**（macOS Foundation Models） | 完全ローカル、超低遅延。プライバシー重視ならこれ |
| **llama.cpp**（GGUF・ローカル実行） | お好みのオープンモデルをオフラインで動かせます |
| **OpenAI 互換 API**（任意のエンドポイント） | OpenAI API や Gemini API の互換接続先を、API キー・モデル名とともに設定できます |

**設定場所**

- **macOS**: メニューバー → AI 設定
- **Windows**: タスクトレイ →「⚙️ AI 設定」

設定できる項目は エンドポイント / API キー / モデル名 / 最大トークン数 / temperature / 有効・無効 です。

### Claude・ChatGPT・Gemini との接続方法

**Claude Desktop / Claude Code** との連携は、下の「8. 応用編：Claude とつなぐ」で説明する MCP 接続です。Claude からペットの状態を確認したり、作業中の進捗をキャラクターの動きで表示したりできます。

**ChatGPT のモデル**を使いたい場合は、OpenAI API のエンドポイント・API キー・モデル名を「AI 設定」に入力します。ChatGPT のウェブ画面やアカウントに直接接続する方式ではありません。API の利用条件や料金は、ChatGPT の契約とは別に確認してください。

**Gemini のモデル**については、Google が [Gemini API の OpenAI 互換エンドポイント](https://ai.google.dev/gemini-api/docs/openai)を公開しています。利用する場合は、対応するエンドポイント・Gemini API キー・モデル名を「AI 設定」に入力します。Gemini アプリのアカウントと直接連携する機能ではありません。接続できる機能は選んだモデルと互換 API の仕様に依存します。

**音声の文字起こし**はこれらのクラウド AI の設定とは別の機能です。macOS 版では端末内で処理し、右 Shift の音声入力のほか、音声ファイルをキャラクターへドロップして書き起こすこともできます。

llama.cpp をローカルで使う場合、コンテキスト長は **8192 以上** を指定してください。足りない場合、一部の機能（お悩み相談など）が使えません。

AI が応答しなかったときは、あらかじめ用意されたセリフに自動で切り替わります。無言になることはありません。

---

## 6. 便利機能

成長にあわせて、少しずつ覚えていきます。

- **クリップボード履歴** — コピーしたものを見返せます。画像の文字起こし（OCR）や要約もできます
- **ブックマーク** — AI が自動でタグ付け・要約します。Chrome / Edge からのインポート、リンク切れチェックにも対応
- **RSS リーダー** — 2 ペイン UI、Vim 風のキー操作、OPML の入出力に対応。読んだ記事の感想を話してくれます
- **ダイナミックスニペット** — 登録したキーワードを打って Space / Tab / Enter を押すと、定型文に展開されます
- **占い** — 生年月日をもとにした 100 タイプ分類、その月の運気、友達占い
- **お悩み相談** — その子が話を聞いてくれます
- **AI 画像生成** — 「〜を描いて」と頼むと絵を描きます。Apple の Image Playground を使うため端末内で完結します（Apple Intelligence 対応機のみ）

ほかにも、使い込むうちに覚える機能があります。

### お悩み相談について

右クリックメニューから始められます。評価もアドバイスの押しつけもせず、ただ聞いて、最後に小さな次の一歩を差し出します。

**会話の内容は保存されません。** ウィンドウを閉じた時点でメモリから消えます。
つらい気持ちが強く出ているときは、専門の相談窓口を画面に表示します。

キャラクターごとに別の会話として扱われます。

---

## 7. ショートカット

### macOS

| キー | 動作 |
|---|---|
| `右Shift` 長押し | 音声入力（0.3 秒以上で開始、離すと停止） |
| `右Shift` ×2 | 音声入力のオン・オフ（0.4 秒以内の 2 回押し） |
| `Shift + Cmd + C` | クリップボード履歴 |
| `Shift + Cmd + B` | ブックマーク |
| `Shift + Cmd + R` | RSS リーダー |
| `Cmd + Q` | 終了 |
| `Cmd + V`（ブックマーク画面内） | URL の一括追加（改行区切り） |

### Windows

| キー | 動作 |
|---|---|
| `右Shift` 長押し / ×2 | 音声入力 |
| `Ctrl + V`（ブックマーク画面内） | URL の一括追加 |

お悩み相談にはショートカットを割り当てていません。右クリックメニューから開いてください。

---

## 8. 応用編：Claude とつなぐ

> macOS 版の先行機能です。Windows 版は今後のアップデートで同じ内容に対応します。

### 何ができるのか

AI Coach は、**Claude から話しかけられる** ようになります。

「うちの子、元気？」と聞けば、Claude が今の体調と気分を教えてくれます。
「ごはんをあげて」と頼めば、確認のうえで、デスクトップの子が実際に食事をします。
そして Claude が長い作業をしている間、机の上の子が跳ねたり立ち止まったりして、その進み具合を知らせます。

画面を見ていなくても、机の上の小さな命の動きで「まだ動いている」「終わった」が分かる。それが、この連携でいちばん作りたかったことです。

Claude を「もうひとつの AI」として足すのではありません。Claude との会話が、デスクトップの小さな命につながる——そういう形を目指しています。

### つなぐのに必要なもの

| | 必要なこと |
|---|---|
| AI Coach | 起動していること。表に出ている子が 1 匹以上いること |
| Claude 側 | AI Coach の連携（MCP サーバー）が登録されていること |
| 設定 | AI Coach 側で連携が有効になっていること |
| メモを一覧する | 保存しているメモを新しい順に並べます。本文は読まず、題名と書き出しだけを見ます |
| メモを読む | 頼まれた 1 件だけ、本文を読みます |
| メモを探す | 題名と本文をまたいで探します |
| メモを書く | 新しく作る・書き換える・末尾に足す、のいずれかを行います |
| メモを捨てる | 1 件をゴミ箱へ移します。元に戻せます |

やりとりは **この端末の中だけ** で完結します。インターネットを経由しません。

> **接続のしかた**: AI Coach の「AI 設定 → 連携」タブを開き、「Claude からの接続を受け付ける」をオンにしてから、Claude Desktop / Claude Code / Cursor 向けの設定をコピーして貼り付けます。接続用プログラムはアプリに同梱されていますが、動かすには PATH の通った Node.js 22 以降が必要です。

### 頼めること

| 頼むこと | 起きること |
|---|---|
| 様子を聞く | 今の健康・空腹・疲れ・気分を読み取り、小さな状態カードにまとめます |
| 最新にする | 表示中の状態を取り直します |
| お世話を頼む | 何をするかの確認カードが出ます。承認するまで実行されません |
| お世話を実行する | 承認したお世話だけが、デスクトップの子に反映されます |
| ひとこと言わせる | Claude が考えた短い言葉を、その子の吹き出しに出します |
| 作業のようすを知らせる | Claude の考え中・作業中・返事待ち・成功・失敗を、その子の動きで伝えます |
| ファイルを見せる | 許可された形式のファイルを、AI Coach のビューアーで開きます |

複数の子がいるときは、名前と状態を並べて表示します。「どの子に何をするか」があいまいなまま実行されることはありません。

![Claude の中に表示された AI Coach のダッシュボード。HP・満腹度・疲労・病気・免疫のバーと、ごはん・寝かせる・起こす・散歩・看病のボタンが並んでいる](https://aic0t.com/assets/mcp/01-dashboard.webp#1476x736 "Claude の中に出る AI Coach のダッシュボード。体調と気分をその場で読み、ボタンからそのままお世話も頼めます。画面は英語表示です。")

### 作業のようすを、その子が知らせる

この連携でいちばん特徴的な機能です。Claude が作業している間、その様子がマスコットの動きに出ます。

![左に Claude 側のダッシュボード、右のデスクトップでロボットのキャラクターが作業中の吹き出しを出している](https://aic0t.com/assets/mcp/03-activity.webp#1950x720 "左が Claude の中のダッシュボード、右が机の上。作業中は 🛠 を出して、その場で跳ねて知らせます。")

| Claude の状態 | その子の様子 |
|---|---|
| 考えている | 歩き回るのをやめて立ち止まり、🤔 を出します |
| 作業している | その場で 1 回跳ねて、🛠 を出します |
| 返事を待っている | 立ち止まったまま続けて跳ね、🙋 を出し続けます |
| うまくいった | 大きく 1 回跳ねて、✅ と喜びます |
| うまくいかなかった | 低く小刻みに跳ねて、⚠️ を出します |
| 終わり | いつもの様子に戻ります |

跳ね方は、**影を地面に残したまま、キャラクターだけが跳ぶ** その場ジャンプです。macOS の Dock アイコンが跳ねるのと同じ動きなので、普段うろうろしているのと確実に見分けられます。

- 長い作業の間、吹き出しを出し続けることはありません。ときどき跳ねて、小さな絵文字を出すだけです
- 考えている間は、逆にうろうろするのをやめて立ち止まります
- **この通知で HP が減ることはありません。** 育成のパラメータには一切触れず、効果音も鳴りません
- 最大 15 分で自動的に消えます。Claude 側が黙って止まっても「作業中」のまま残りません
- 眠っている子・卵・ゴースト・しまっている子には表示しません。相談中・会話中・文字起こし中も同じです
- 跳ねるのが気になる場合は、設定の「跳ねる演出」をオフにしてください
- 作業中でも、つまんだときの反応や欲求の訴えはそのままです。置物にはなりません

### お世話を頼む

Claude に頼めるのは **ごはん / 寝かせる / 起こす / 散歩 / 看病** の 5 つだけです。

**必ず確認が出ます。** Claude の判断だけで育成のパラメータが変わる経路はありません。

ダッシュボードのボタンから操作する場合は「次回から表示しない」で確認を省略できますが、**Claude から頼まれたお世話は、その設定にかかわらず毎回確認します。**

![この操作を実行しますかと尋ねる確認カード。ごはんの実行ボタン、取り消しボタン、確認の残り時間が並んでいる](https://aic0t.com/assets/mcp/02-care.webp#1476x624 "お世話は必ずこの確認カードを挟みます。承認するまで、育成のパラメータは動きません。")

購入・孵化・命名・キャラクターの変更・恋愛や産卵・お別れは、連携の対象外です。これらは、あなたの手で決めることだからです。

### ファイルを見せてもらう

Claude が扱っているローカルファイルを、AI Coach のビューアーで開けます。

| 種類 | 拡張子 | 上限 |
|---|---|---|
| テキスト / Markdown / Mermaid | `txt` `md` `markdown` `mmd` `mermaid` | 2 MiB（UTF-8） |
| 画像 | `jpg` `jpeg` `png` `heic` `webp` `svg` | 25 MiB |

- **ファイルを読むのは AI Coach だけです。** 中身も、画像データも、フルパスも Claude には返りません
- Mermaid はアプリに同梱した描画エンジンで表示します。外部へ取りに行きません
- SVG は、スクリプトや外部参照を含むものを開きません
- 拡張子だけで判断せず、中身を確かめたうえで表示します

「このファイル、AI Coach で見せて」と頼めば、内容を Claude に読ませることなく、手元の画面だけで確認できます。

### メモを読み書きしてもらう

思いついたことを Claude に書き留めてもらったり、前に書いたメモを探してもらったりできます。プラグインも
別のサーバーも要りません。AI Coach だけで完結します。

![Claude の返答としてメモの一覧が 3 件、題名と分類だけ並んでいる](https://aic0t.com/assets/mcp/04-notes.webp#1476x430 "「メモを一覧して」と頼んだところ。渡るのは題名と分類だけで、本文は読みに行きません。")

| 保存先 | 既定の場所 |
|---|---|
| macOS | `~/Library/Application Support/AICoach/Memos/` |
| Windows | `%APPDATA%\AICoach\Memos\` |

- 保存先は設定で好きなフォルダに変えられます。Obsidian の保管庫をそのまま指すこともできます
- 中身はただの Markdown ファイルです。アプリ独自の形式ではないので、ほかのエディタでも開けます
- **Claude が勝手にメモを読み漁ることはありません。** 一覧で渡るのは題名と書き出しだけで、本文が渡るのは
  「読んで」「探して」と頼んだときだけです
- 一度に書ける本文は 32 KiB、読み取りも一度に 32 KiB までです（長いメモは分けて読みます）。1 件の上限は 1 MiB
- 一覧は最大 200 件、検索結果は最大 50 件までです
- 書き換えるときは、読んだ時点から変わっていないかを確かめます。ほかで編集されていたら上書きせず読み直します
- 消すときは OS のゴミ箱へ移すので、間違えても元に戻せます

### Claude に渡しておくとよい指示

Claude の「指示（Instructions）」に次の内容を貼っておくと、いちいち頼まなくても作業のようすを知らせてくれるようになります。そのままコピーしてお使いください。

```text
あなたは AI Coach と連携しています。利用可能な AI Coach の MCP ツールを、次の規則で使ってください。

【基本方針】
- 通知は補助表示です。重要な結果・質問・エラーは必ず回答本文にも書いてください。
- 挨拶や一文質問を除き、調査・編集・生成・ビルド・テストなど複数手順の作業では状況を通知してください。
- 通知に秘密情報、認証情報、個人情報、ファイル本文、長いログを含めないでください。

【作業状況】
- 方針を考えるときは `report_ai_coach_activity` の `thinking`、実作業中は `working` を使ってください。
- ユーザーの回答や承認を待つ直前は `waiting`、完了時は `succeeded`、完了不能が確定したときは `failed` を一度だけ送ってください。
- `label` は状況が分かる60文字以内の短い文にしてください。同じ状態と文言を繰り返し送らないでください。

【状態確認とお世話】
- 様子を尋ねられたら `open_ai_coach_dashboard` または `refresh_ai_coach_status` を使ってください。
- お世話は `prepare_ai_coach_care` で内容を示し、ユーザーが明示的に確認した後だけ `commit_ai_coach_care` を使ってください。独断で実行しないでください。

【メッセージとファイル】
- `show_ai_coach_message` は短い励ましや、ユーザーがマスコットに言わせたい内容だけに使ってください。
- `show_ai_coach_file` はユーザーが表示を頼んだローカルファイルに限って使い、内容やフルパスを回答・通知へ転載しないでください。

【メモ】
- メモの読み書きは、ユーザーがメモを探す・読む・書き残すと言ったときだけ行い、勝手に読み漁らないでください。
- 既存メモを書き換えるときは、必ず読んでから `expectedModifiedAt` を渡し、競合したら上書きせず読み直してください。
- 32 KiB を超える本文は、作成してから追記に分けてください。削除は依頼されたときだけ行ってください。
- メモの本文を、依頼された用途以外へ転記しないでください。

【失敗時】
- AI Coach が未起動・未接続でも、本来の依頼を続けられるなら継続してください。同じ接続失敗を繰り返し再試行しないでください。
- 最終回答は、マスコットの表示を見ていなくても結果と次の操作が分かる内容にしてください。
```

ねらいはひとつです。**「始めたことは、終わったことも知らせる」** — 作業の始まりだけ跳ねて、終わりが分からないまま、という状態を作らないためのものです。

### 安全とプライバシー

- Claude に渡すのは、体調や気分といった **必要最小限** の情報だけです
- 個人情報、認証情報、API キー、セーブデータ全体は渡しません
- クリップボード、予定、RSS、文字起こしの内容を自動で送ることはありません
- キャラクターの画像や素材を外部へ渡すことはありません
- その子を指す ID は仮名です。別の端末や別のインストールと突き合わせることはできません。設定で「起動のたびに変える」ことも選べます
- 状態を変える操作は、必ずあなたの確認を経ます
- 連携は設定でいつでも切れます

**ただし、Claude に見せた情報は Claude 側の処理の対象になります。** 端末の中で完結する連携であっても、そこは変わりません。渡したくないものは渡さない、という前提でお使いください。

---

## 9. アカウントと同期

### サインイン

アカウントを作らなくても、すぐに使い始められます。あとから **Google** アカウントを紐付けられます。

サインインが必要になるのは次の場合です。

- 卵を購入するとき
- 別の端末にデータを引き継ぐとき

### 同期されるもの

サインインしていると、次のデータがクラウドに保存されます。

- キャラクターの状態（体調・成長・血統・関係・思い出）
- 飼い主のプロフィール（ニックネーム・生年月日・生まれた時間）
- 卵の購入実績
- RSS の登録フィード、ダイナミックスニペット、カスタムプロンプト

同期されないもの：音声文字起こしの履歴、ウィンドウの位置、キャッシュ。

> クラウド同期は、卵を 1 個以上購入したアカウントで有効になります。アプリ同梱の卵だけでお使いの場合、データは端末の中にのみ保存されます。

### 同期のタイミング

同期はアプリが自動で行います。設定も操作も必要ありません。

- **保存**：「お家に帰る」を実行したとき / ゴーストになったとき / アプリ終了時 / スリープ時
- **読み込み**：起動時 / スリープ復帰時 / サインイン時 / 購入が反映されたとき

**育成はオフラインでも進みます。** ネットに繋がっていなくても、いつも一緒にいられます。

### 別の端末で続ける

新しい端末で同じアカウントにサインインすると、データを引き継げます。まだ何も育てていない端末なら、そのままクラウドのデータが入ります。

複数の端末で育てた場合は自動でまとめられます。購入実績と育ちの記録が巻き戻ることはありません。ただし体調（HP・満腹度・疲労）は新しい記録が優先されるため、前後することがあります。

**最後の更新が 7 日以上離れている場合のみ**、どちらを使うか確認のダイアログが出ます。どちらを選んでも購入実績は必ず引き継がれます。

---

## 10. 卵を購入する

### プラン

| | 価格 | 卵 | 1 個あたり |
|---|---|---|---|
| アプリ同梱 | 無料 | 1 個 | — |
| STARTER | $5 USD | 1 個 | $5 |
| BUNDLE | $20 USD | 5 個 | $4（20% お得） |

**買い切りです。** サブスクリプションではありません。一度購入すれば追加料金はかかりません。

### 買いかた

1. アプリのメニュー →「卵を購入…」でブラウザが開きます（または aic0t.com から直接）
2. Google またはメールアドレスでサインインします
3. 数を選んで Stripe Checkout に進みます
4. 決済すると、卵が孵化トレイに届きます

カード / Apple Pay / Google Pay / Link に対応しています。決済は Stripe が処理し、当社がカード情報を預かることはありません。領収書は自動でメールされます。

### 反映のタイミング

決済完了後、アプリを起動している場合はそのまま届きます。起動していない場合は、次にアプリを起動したときに孵化トレイに現れます。

### プレミアムエッグについて

購入した卵から生まれる子は、第 1 世代の基礎能力（最大 HP や免疫の初期値）が少し高くなります。ごく稀に、限定のカラーで生まれることもあります。

**Pay to Win ではありません。** どんな姿になるかは指定できません。それは育て方が決めることです。

### 返金

購入から **7 日以内** で、返金対象の卵をまだ孵化（育成開始）していない場合に申請できます。5 個パックのうち一部だけが未使用の場合は、その分の一部返金も検討します。お問い合わせフォームからご連絡ください。

このポリシーは、適用される法令上の権利を制限するものではありません。

---

## 11. プライバシーとデータ

### ローカルで動くもの

- 音声の文字起こし（macOS では完全オフライン処理）
- Apple オンデバイス LLM / llama.cpp を選んだ場合の AI 処理
- セーブデータの読み書き

セーブデータは **AES-256-GCM で暗号化** してローカルに保存されます。キャラクターの画像やデータも暗号化コンテナに収められており、復号はメモリ内でのみ行われます。

### 外部に送られるもの

- **OpenAI 互換 API を設定した場合**：AI に渡す内容が、指定したエンドポイントに送信されます
- **Deep Context を有効にした場合**：アクティブなアプリ名・ウィンドウタイトル・選択中のテキストが、AI へのヒントとして使われます。オフにすれば一切取得しません
- **ブックマークの AI タグ付け・要約**：ページの内容が AI に渡されます
- **RSS リーダー**：フィードの取得に通信します
- **クラウド同期**：上記「同期されるもの」の内容
- Claude 連携（MCP）を有効にした場合：体調・気分などの状態と、あなたが読み書きを頼んだメモの本文が Claude に渡ります。ファイルプレビューで開いたファイルの中身・画像・フルパスは渡りません

**AI は基本はローカルで動作します。** クラウド連携はオプトイン方式で、設定で明示的に有効化したときだけ有効になります。

**お悩み相談の会話は保存しません。** セッションを終えるとメモリから消えます。

### データの保存場所

- **macOS**: `~/Library/Application Support/AICoach/`
- **Windows**: `%LOCALAPPDATA%\AICoach\`

クラウド側のデータは東京リージョン（`asia-northeast1`）に保存され、自分のアカウント以外からは読み書きできません。

### 記録を消す

すべての記録を消すこともできます。育てた命と血統、図鑑のすべてが失われ、最初の余白に戻ります。**この操作は取り消せません。**

### 第三者への提供

**売りません。渡しません。** 育てた記録も、メモも、文字起こしの内容も、第三者へ販売・貸与・提供することは
ありません。広告目的の収集も、第三者トラッカーの埋め込みも行いません。

端末の外へ出るのは、上の「外部に送られるもの」に挙げた、あなたが設定で選んだ経路だけです。

| 相手 | 何のために | あなたの選択 |
|---|---|---|
| 指定した OpenAI 互換エンドポイント | AI 処理 | 設定で明示的に有効化したときだけ |
| Google Firebase（東京リージョン） | クラウド同期 | サインインしたときだけ |
| Stripe | 卵の購入の決済 | 購入したときだけ |
| Claude（MCP 連携） | 連携で頼んだ操作 | 連携を有効にしたときだけ |

法令に基づく開示要請に応じる場合を除きます。

### 保持期間

| 対象 | どれだけ残るか |
|---|---|
| セーブデータ（育成・血統・図鑑） | あなたが消すまで、端末に残ります |
| メモ | あなたが消すまで残ります。削除は OS のゴミ箱への移動です |
| お悩み相談の会話 | **保存しません。** セッションを終えるとメモリから消えます |
| 音声入力の音声 | **保存しません。** 文字にした時点で破棄します |
| Claude 連携の作業表示 | 最大 15 分で自動的に消えます |
| クラウド同期のデータ | アカウントがある間。退会すると削除されます |

アプリを削除しても、保存フォルダは自動では消えません。すべて消したいときは「記録を消す」を実行するか、
上記の保存先フォルダごと削除してください。

### 連絡先

プライバシーとデータの扱いについてのお問い合わせは、サイトのお問い合わせフォーム、または
contact.aicoach@gmail.com までご連絡ください。

---

## 12. 対応言語

日本語 / English / 简体中文 / 繁體中文 / Español の 5 言語に対応しています。

表示言語は **OS のシステム言語** に合わせて自動で選ばれます。

- **macOS**: システム設定 → 言語と地域
- **Windows**: 設定 → 時刻と言語 → 言語

対応していない言語の環境では英語で表示されます。

---

## 13. 動作環境

| | macOS | Windows |
|---|---|---|
| OS | macOS 26 以降 | Windows 10 / 11 |
| 推奨 | 最新の macOS | Windows 11 |
| CPU | Apple Silicon | x64 |
| Framework | Swift 6.2 / AppKit | C++ / WinUI 3 |

一部の機能でインターネット接続が必要です。同期は Firebase を利用しています。macOS 版は Apple Silicon 専用です。Windows 版は開発中・近日公開予定で、現時点では配布していません。

### macOS 版と Windows 版の違い

Windows 版では、次の機能がまだ利用できません。順次対応していきます。

- お悩み相談
- アカウント連携とクラウド同期
- クリップボード履歴・ブックマーク・RSS のショートカットキー（メニューからは利用できます）
- AI 画像生成
- 一部の演出

---

## 14. こまったときは

**キャラクターが出てこない**
メニューバー（macOS）またはタスクトレイ（Windows）から「キャラクター管理」を開き、しまわれていないか確認してください。ゴーストになっている場合も、しまわれた子から呼び戻せます。

**卵が孵らない**
卵は時間の経過だけで孵ります。餌は必要ありません。しまっている間は時間が進まないので、画面に出したままお待ちください。

**音声入力が反応しない**
1. まだ卵の場合は、孵化するまで音声入力は解放されません（仕様）
2. マイクの権限が許可されているか確認してください
3. 右 Shift を **0.3 秒以上** 押しているか確認してください（短いと反応しません）
4. 他のアプリが右 Shift を専有していないか確認してください

**文字起こしの結果が他のアプリに入らない**
自動入力にはアクセシビリティ権限が必要です。設定で許可してください。また、自動入力の設定がオンになっているか確認してください。

**AI が応答しない**
AI 設定でエンドポイントとモデル名を確認してください。llama.cpp を使う場合はコンテキスト長が 8192 以上必要です。応答がないときは自動で通常のセリフに切り替わります。

**買った卵が届かない**
アプリを再起動してから孵化トレイを確認してください。それでも届かない場合は、購入時のメールアドレスを添えてお問い合わせください。

**別の端末にデータが引き継がれない**
両方の端末で同じ Google / メールアカウントにサインインしているか確認してください。同期は卵を 1 個以上購入したアカウントで有効になります。

**病気が治らない**
「看病する」は 1 時間に 1 回まで有効です。免疫力が高いと自然に回復していきます。お腹を満たして、しっかり寝かせてあげてください。

**Claude から AI Coach が見つからない**
AI Coach が起動しているか、連携が有効になっているかを確認してください。接続情報はアプリの起動ごとに作り直されるため、一度 AI Coach を再起動すると解決することがあります。

**Claude に頼んだのに、何も起きない**
眠っている子・卵・ゴースト・しまっている子には表示されません。相談中・会話中・文字起こし中も同じです。別の子を表に出してから、もう一度お試しください。跳ねる演出だけが出ない場合は、設定の「跳ねる演出」がオフになっていないか確認してください。

**作業中の表示が出たままになる**
最大 15 分で自動的に消えます。すぐ消したいときは、Claude に作業の終了を伝えるか、その子を一度しまってください。

---

## お問い合わせ

解決しない場合は、サイトのお問い合わせフォームからご連絡ください。
FAQ もあわせてご覧ください。

## English documentation

Source: https://aic0t.com/docs/en.md

# AI Coach Documentation

A guide for the small companion who moves into the corner of your desktop.
If this is your first time, we suggest reading straight through from "1. Getting started."

> This documentation covers the AI Coach v1.0.0 stable release. Details may change in future updates.

---

## 1. Getting started

### What AI Coach is

AI Coach is an AI character who lives on your desktop.
It comes with a full set of small tools for voice input, AI, and everyday work — but the thing that makes it different is that **you raise it from an egg**. How you use it shapes who it becomes.

Even if your character is gone, the main features (voice transcription, AI, utilities) keep working. Your desktop just gets a little lonelier.

### Installing

**macOS**

1. Open the `.dmg` you downloaded and drag `AI Coach.app` into your Applications folder.
2. The first time you launch it, right-click and choose "Open."
3. A mascot appears in the lower right of your desktop, and an icon is added to the menu bar. Nothing appears in the Dock (it runs as a menu bar app).

**Windows**

> The Windows version is in development and coming soon. No installer is distributed yet; the steps below apply once it is released.

1. Run the installer (`AICoach-Setup-x.x.x.exe`).
2. After installation, launch it from the Start menu.
3. An icon is added to the task tray.

### Permissions you'll need

| Permission | What it's for | Where to set it |
|---|---|---|
| Microphone | Voice input (transcription) | macOS: System Settings → Privacy & Security → Microphone |
| Accessibility | Reading selected text, typing into other apps | macOS: System Settings → Privacy & Security → Accessibility |

The app works fine without these — only the related features go unavailable. (If Accessibility isn't granted, text retrieval simply comes back empty; nothing crashes.)

### Launching automatically at login

- **macOS**: Menu bar → Settings → "Launch at login"
- **Windows**: Task tray → "🔄 Launch at login"

### Quitting

- **macOS**: Menu bar → "Quit AI Coach," or `Cmd + Q`
- **Windows**: Quit from the task tray menu

When you'd like a little quiet, "Go home" in the right-click menu tucks your character away.

---

## 2. Eggs, and your first one

### Getting your egg

**One first egg** is included when you download the app. There's nothing to claim or redeem.

You can buy more eggs on the website (→ "10. Buying eggs"). Purchased eggs arrive in the **Hatch Tray**.

### The Hatch Tray

The Hatch Tray shows how many eggs you have yet to hatch.

- **macOS**: Menu bar → "Hatch Tray"
- **Windows**: Task tray → stock count

Press "Raise" to spend one egg and place it on your desktop.

### Until it hatches

Eggs **grow on their own, simply with time**. There's no feeding to do.

- After a while the shell starts to crack, and eventually someone comes out.
- Time keeps counting even while the app is closed.
- Eggs don't talk. They don't wander. When they get hungry, they shiver a little.
- Eggs never get sick and never die. You can wait without worrying.

> **What an egg can't do yet (by design)**: voice input, clipboard history, bookmarks, the RSS reader, and fortune telling aren't available while it's still an egg. They unlock in order once it hatches into a baby and grows. Hatching takes about an hour, and time passes while the app is closed too.

Once it hatches, a **naming dialog** appears. You can change the name later (right-click → "Rename").

### A scene you'll only see once

If you launch the app for the very first time with no saved data, a short scene plays: light flickering in the dark margins, an egg appearing, a bit of narration. It happens exactly once.

---

## 3. Raising them

### What you can do

Right-click your character to see what's available at that moment.

| Action | What it does |
|---|---|
| Feed | Restores fullness. Only accepted when they're hungry |
| Put to sleep | Restores health and rest. Won't work on an empty stomach |
| Play | Builds a stronger body. Costs fullness and adds fatigue (from toddler stage) |
| Study | Makes them smarter (from toddler stage) |
| Nurse | Only while they're sick. Speeds recovery, and means the most to them |
| Walk | Makes them lighter on their feet |
| View status | Check how they're doing right now |
| View relationships | Check how they get along with the others |
| Put away / Go home | Temporarily tucks them off screen |

You can also pick them up with the mouse and move them around, or drop files on them to feed them.

### Three needs

Characters have three needs: hungry, sleepy, and lonely. When a need builds up, they'll let you know.

**Loneliness** is a little different. Food and sleep won't touch it.

- Picking them up and moving them, playing, nursing — loneliness goes down
- Throwing them — loneliness goes up
- **While two or more are out at once, loneliness doesn't build up at all**

If you answer a need **within 30 seconds** of them asking, they're extra happy about it.

### Condition

- **HP**: At 0, their life ends. Playing raises the maximum
- **Fullness**: While it sits at 0, HP keeps draining
- **Fatigue**: Builds up from activity, recovers with sleep
- **Immunity**: Rises when they stay fed and unfatigued. Illness progresses faster when it's low
- **Illness**: As it advances they resist walks and lose their appetite. When it gets bad, they stop speaking up on their own

If you launch the app after a gap of 8 hours or more, there's a bonus that restores immunity.

### How you raise them becomes who they are

The one who played a lot, the one who studied a lot, the one who got plenty of affection — how you spend your time shifts which parameters grow, and that decides **what they look like as an adult**.

You won't know which form you'll get until they grow up.
Telling you all of them would spoil the fun, so we're keeping that to ourselves here.

### Personality and the way they talk

Characters watch how you respond and adjust how they speak.

A child who got what they wanted by being clingy becomes good at being clingy; one who got through by reasoning with you starts talking like an equal partner. Tugging at your sympathy, offering you a deal, complimenting you, or just being adorable — each is that child's own way of saying "look at me again."

The way they talk also changes with their stage. Babies babble, toddlers use short words, kids speak in sentences, and adults choose their words.

---

## 4. Growing up, and what comes after

### Stages

**Egg → Baby → Toddler → Kid → Adult**

Each stage opens up more. Play and study arrive in the toddler stage, matchmaking in the kid stage, and marriage and egg-laying as adults. Along the way, **utilities unlock bit by bit, in the form of "I learned it!"**

Reaching adulthood takes about a month (give or take, depending on how you raise them).

Time doesn't pass while they're put away (dormant). Think of it as hibernation.

### How many can you raise?

- Up to **6 at once** on screen (up to 8 including eggs)
- No limit on how many you can keep put away
- Manage them from the macOS menu bar → "🐣 Character management," or from the task tray on Windows

### Living together

With two or more out at once, they drift toward each other and away again, talk, and trade feelings in emoji. They can become close — or fall out.

When an adult boy and girl are near each other, **love can quietly find them**. You can't "arrange a marriage." That's theirs to choose.

Once two become a couple, they may lay an egg when the conditions line up. Laying an egg means giving up some of their own remaining time (maximum HP) and entrusting it to the next life. Each egg carries three generations of lineage.

You can see the family tree from the macOS menu bar → "👪 View family tree."

### The end of a life

When HP reaches 0, that child becomes a **ghost**.

Just before becoming a ghost, they look back over the days you spent together, thank you for whatever you shared most often, and go to sleep.

Ghosts stay with you as translucent figures. They don't get hungry, don't get sick, and have no lifespan. No love, no eggs. You can put them away and call them back again.

When you're ready to let go, you can choose "Let them go." After a confirmation, they return to the margins. **Holding on and letting go are both ways of loving.**

Even after you let them go, their record stays in the Encyclopedia.

### The Encyclopedia

The forms you've met, the records of the children you raised, the days they lived — it all gathers here.
Forms you haven't met yet are hidden, frame and all. We hope you'll go looking for what's behind them.

---

## 5. Voice and AI

### Talk with Right-Shift

**Hold Right-Shift for 0.3 seconds or more** and your voice becomes text. Let go and it stops.
**Tap Right-Shift twice quickly** (within 0.4 seconds) to toggle start and stop without holding it down.

- While recording, the speech bubble shows a waveform and the text as it's recognized
- Results can be typed straight into whatever app is active (auto-typing can be switched on or off in settings)
- You can also drop audio files onto your character to transcribe them (macOS)
- Registering custom vocabulary improves accuracy for names and specialized terms
- On macOS, transcription is processed entirely locally

### Choosing an AI engine

Pick whichever suits what you're doing.

| Option | What it's like |
|---|---|
| **Apple on-device LLM** (macOS Foundation Models) | Fully local, ultra-low latency. Pick this if privacy comes first |
| **llama.cpp** (GGUF · run locally) | Run your favorite open model offline |
| **OpenAI-compatible API** (any endpoint) | ChatGPT or your own API — just swap the URL |

**Where to set it**

- **macOS**: Menu bar → AI Settings
- **Windows**: Task tray → "⚙️ AI Settings"

The settings available are endpoint / API key / model name / max tokens / temperature / enabled or disabled.

If you're running llama.cpp locally, set the context length to **8192 or more**. With less than that, some features (Consultation, for example) won't work.

If the AI doesn't respond, the app automatically falls back to pre-written lines. Your character never goes silent.

---

## 6. Utilities

They pick these up gradually as they grow.

- **Clipboard history** — Look back at what you've copied. Can also transcribe text from images (OCR) and summarize
- **Bookmarks** — The AI tags and summarizes automatically. Supports importing from Chrome / Edge and checking for dead links
- **RSS reader** — Two-pane UI, Vim-style key handling, OPML import and export. Your character shares thoughts on articles you've read
- **Dynamic snippets** — Type a keyword you've registered and press Space / Tab / Enter to expand it into boilerplate
- **Fortune telling** — A 100-type classification based on your birth date, the month's outlook, and readings for friends
- **Consultation** — Your character listens
- **AI image generation** — Ask for a picture and they draw one. It uses Apple's Image Playground, so it stays on your machine (Apple Intelligence capable devices only)

There are others they'll learn as you keep using the app.

### About Consultation

Start it from the right-click menu. No judgment, no advice pushed on you — just listening, and one small next step offered at the end.

**Conversations are not saved.** They're cleared from memory the moment you close the window.
If strong distress comes through, the app shows professional support resources on screen.

Each character keeps its own separate conversation.

---

## 7. Shortcuts

### macOS

| Key | Action |
|---|---|
| Hold `Right-Shift` | Voice input (starts at 0.3 seconds, stops on release) |
| `Right-Shift` ×2 | Toggle voice input (two taps within 0.4 seconds) |
| `Shift + Cmd + C` | Clipboard history |
| `Shift + Cmd + B` | Bookmarks |
| `Shift + Cmd + R` | RSS reader |
| `Cmd + Q` | Quit |
| `Cmd + V` (in the Bookmarks window) | Add URLs in bulk (one per line) |

### Windows

| Key | Action |
|---|---|
| Hold `Right-Shift` / ×2 | Voice input |
| `Ctrl + V` (in the Bookmarks window) | Add URLs in bulk |

Consultation has no shortcut assigned. Open it from the right-click menu.

---

## 8. Going further: connecting Claude

> This feature is available on macOS first. Windows support will follow in a future update.

### What it lets you do

AI Coach can be **talked to from Claude**.

Ask "how's my little one doing?" and Claude tells you their condition and mood.
Ask it to "feed them" and — after you confirm — the character on your desktop actually eats.
And while Claude works on something long, the little one on your desk hops and pauses to show you how it's going.

Even when you're not watching the screen, the movement of that small life on your desk tells you "still running" or "done." That's the thing we most wanted to build here.

This isn't about bolting on "one more AI." It's about letting a conversation with Claude reach the small life on your desktop.

### What you need

| | What's required |
|---|---|
| AI Coach | Running, with at least one character out on screen |
| Claude side | The AI Coach integration (MCP server) registered |
| Settings | The integration enabled on the AI Coach side |
| List your memos | Lines up your saved memos, newest first. It doesn't read the bodies — only titles and opening lines |
| Read a memo | Reads the body of the one memo you asked about |
| Search your memos | Looks across titles and bodies |
| Write a memo | Creates a new one, rewrites one, or adds to the end of one |
| Throw a memo away | Moves one to the trash. It can be brought back |

Everything happens **inside this machine**. Nothing goes over the internet.

> **How to connect**: open AI Settings → Integration in AI Coach, turn on "Accept connections from Claude," then copy the ready-made settings for Claude Desktop, Claude Code, or Cursor. The connection program ships inside the app, but running it needs Node.js 22 or later on your PATH.

### What you can ask for

| What you ask | What happens |
|---|---|
| How they're doing | Reads their current health, hunger, tiredness, and mood into a small status card |
| Refresh | Fetches the displayed state again |
| Prepare care | Shows a confirmation card describing what will be done. Nothing runs until you approve |
| Apply care | Only the care you approved is applied to the character on your desktop |
| Say something | Puts a short line Claude wrote into that character's speech bubble |
| Report activity | Shows Claude thinking, working, waiting, succeeding, or failing through that character's movement |
| Preview a file | Opens a file of an allowed type in the AI Coach viewer |

With several characters, names and states are listed side by side. Nothing runs while "which one, and what" is still ambiguous.

![The AI Coach dashboard shown inside Claude, with bars for HP, satiety, fatigue, illness and immunity, and buttons for feed, sleep, wake, walk and nurse](https://aic0t.com/assets/mcp/01-dashboard.webp#1476x736 "The AI Coach dashboard, drawn inside Claude. It reads their condition and mood on the spot, and the buttons ask for care without leaving the conversation.")

### Your character shows you how the work is going

This is the most distinctive part of the integration. While Claude works, that work shows up in how your mascot moves.

![The dashboard inside Claude on the left, and on the right a robot character on the desktop showing a hard-at-work speech bubble](https://aic0t.com/assets/mcp/03-activity.webp#1950x720 "The dashboard inside Claude on the left, your desk on the right. While the work runs, they show 🛠 and hop in place to say so.")

| Claude's state | What your character does |
|---|---|
| Thinking | Stops wandering, stands still, shows 🤔 |
| Working | Hops once in place, shows 🛠 |
| Waiting for you | Stands still and keeps hopping, holding up 🙋 |
| Succeeded | One big hop, ✅, and a happy motion |
| Failed | Low, quick hops with ⚠️ |
| Done | Back to their usual self |

The hop keeps **the shadow on the ground while only the character jumps** — the same motion as a bouncing macOS Dock icon, so you can always tell it apart from their ordinary wandering.

- During long work there's no stream of speech bubbles. Just an occasional hop and a small emoji
- While thinking, they do the opposite: they stop wandering and hold still
- **These notifications never cost HP.** They don't touch a single raising parameter, and there's no sound
- They clear themselves after 15 minutes at most. If Claude stops without a word, you're not left with a permanent "working"
- Nothing is shown on a sleeping character, an egg, a ghost, or one that's put away. Same during consultation, conversation, or transcription
- If the hopping bothers you, turn off "bounce effects" in settings
- Even mid-work, they still react when you pick them up and still tell you what they need. They don't become an ornament

### Asking for care

Claude can only ask for five things: **feed, sleep, wake, walk, nurse**.

**You are always asked to confirm.** There is no path where a raising parameter changes on Claude's judgment alone.

For the dashboard buttons you can skip confirmation with "don't show this again" — but **care requested by Claude is confirmed every single time, regardless of that setting.**

![A confirmation card asking whether to apply this action, with an Apply button for feeding, a Cancel button, and the time left to confirm](https://aic0t.com/assets/mcp/02-care.webp#1476x624 "Care always goes through this card. Nothing in their raising parameters moves until you approve it.")

Buying, hatching, naming, switching characters, romance and egg-laying, and saying goodbye are all outside the integration. Those are yours to decide.

### Having a file shown to you

A local file Claude is working with can be opened in the AI Coach viewer.

| Kind | Extensions | Limit |
|---|---|---|
| Text / Markdown / Mermaid | `txt` `md` `markdown` `mmd` `mermaid` | 2 MiB (UTF-8) |
| Images | `jpg` `jpeg` `png` `heic` `webp` `svg` | 25 MiB |

- **Only AI Coach reads the file.** Its contents, image bytes, and full path never go back to Claude
- Mermaid renders with the engine bundled in the app. Nothing is fetched from outside
- SVGs containing scripts or external references are not opened
- The extension alone isn't trusted — the contents are checked before anything is displayed

Ask "show me this file in AI Coach" and you can look it over on your own screen without Claude reading it.

### Having your memos read and written

You can have Claude jot something down for you, or dig out a memo you wrote earlier. No plugin and no
second server — AI Coach handles all of it.

![A reply from Claude listing three memos, showing only their titles and groups](https://aic0t.com/assets/mcp/04-notes.webp#1476x430 "Asking it to list your memos. Only titles and groups cross over — it does not go and read the bodies.")

| Where they live | Default location |
|---|---|
| macOS | `~/Library/Application Support/AICoach/Memos/` |
| Windows | `%APPDATA%\AICoach\Memos\` |

- You can point this at any folder you like in settings — including an Obsidian vault, as it is
- They're plain Markdown files, not some private format. Any editor opens them
- **Claude doesn't go rummaging through them.** Listing returns titles and opening lines only; a body
  reaches Claude only when you ask it to read or search
- Up to 32 KiB is written at a time, and up to 32 KiB read at a time (a long memo comes back in pieces).
  A single memo can hold up to 1 MiB
- A listing returns at most 200 memos, a search at most 50 results
- Before rewriting one, it checks that nothing changed since it read it. If something else edited the
  file in the meantime, it re-reads instead of overwriting
- Deleting moves the file to your operating system's trash, so a mistake can be undone

### An instruction worth giving Claude

Paste the following into Claude's Instructions and it will report on its work without being asked each time. Copy it as is.

```text
You are connected to AI Coach. Use the available AI Coach MCP tools according to these rules.

[Basics]
- Notifications are supplementary. Always include important results, questions, and errors in your response.
- Except for greetings and one-line questions, report progress for multi-step research, editing, generation, builds, and tests.
- Never include secrets, credentials, personal data, file contents, or long logs in notifications.

[Work status]
- Use `thinking` with `report_ai_coach_activity` while planning, and `working` during active work.
- Send `waiting` immediately before asking for an answer or approval, `succeeded` once when verified work is complete, and `failed` once only when completion is no longer possible.
- Keep `label` under 60 characters and make it describe the current state. Do not repeat the same state and label.

[Status and care]
- When asked how the mascots are doing, use `open_ai_coach_dashboard` or `refresh_ai_coach_status`.
- Show the proposed care action with `prepare_ai_coach_care`, then use `commit_ai_coach_care` only after explicit user confirmation. Never perform care on your own.

[Messages and files]
- Use `show_ai_coach_message` only for a short encouragement or something the user wants the mascot to say.
- Use `show_ai_coach_file` only for a local file the user asked to display. Do not copy its contents or full path into responses or notifications.

[Memos]
- Read or write memos only when the user asks to find, read, or note something down. Do not go browsing through them.
- Before rewriting an existing memo, read it first and pass `expectedModifiedAt`. On a conflict, re-read instead of overwriting.
- For a body over 32 KiB, create the memo and then append. Delete only when asked.
- Do not copy a memo's contents anywhere beyond what was asked for.

[If unavailable]
- If AI Coach is not running or connected, continue the primary task when possible. Do not repeatedly retry the same connection failure.
- Write the final response so the result and next step are clear even if the user did not see the mascot.
```

It exists for one reason: **what starts should also be reported as finished.** No hopping at the beginning of a job and silence at the end.

### Safety and privacy

- Claude only receives the **bare minimum** — condition, mood, and the like
- Personal data, credentials, API keys, and your save data as a whole are never handed over
- Clipboard, calendar, RSS, and transcription contents are never sent automatically
- Character artwork and assets never leave the app
- The ID that refers to a character is a pseudonym. It can't be matched against another machine or another installation. You can also set it to change on every launch
- Anything that changes state always goes through your confirmation
- You can switch the integration off at any time in settings

**That said, whatever you show Claude becomes subject to Claude's processing.** That stays true even for an integration that runs entirely on your machine. Please use it on the assumption that what you don't want to share, you don't share.

---

## 9. Account and sync

### Signing in

You can start using the app right away without creating an account. You can link a **Google** account later.

You'll need to sign in in these cases:

- Buying eggs
- Carrying your data over to another device

### What gets synced

While you're signed in, the following is saved to the cloud:

- Character state (condition, growth, lineage, relationships, memories)
- Your owner profile (nickname, date of birth, time of birth)
- Egg purchase history
- Your RSS feeds, dynamic snippets, and custom prompts

Not synced: voice transcription history, window positions, and caches.

> Cloud sync becomes active on accounts that have purchased at least one egg. If you're using only the egg bundled with the app, your data stays on that device.

### When sync happens

The app handles sync on its own. Nothing to configure, nothing to do.

- **Save**: when you use "Go home" / when a character becomes a ghost / when you quit the app / on sleep
- **Load**: at launch / on waking from sleep / when you sign in / when a purchase comes through

**Raising them continues offline.** You can be together whether or not you're connected.

### Continuing on another device

Sign in to the same account on a new device and your data comes with you. If you haven't raised anything yet on that device, the cloud data simply loads in.

If you've raised characters on more than one device, they're merged automatically. Purchase history and growth records never roll back. Condition (HP, fullness, fatigue) does favor the newer record, so those values may shift up or down.

**Only when the last updates are 7 or more days apart** will a dialog ask which one to use. Either way, your purchase history always carries over.

---

## 10. Buying eggs

### Plans

| | Price | Eggs | Per egg |
|---|---|---|---|
| Included with the app | Free | 1 | — |
| STARTER | $5 USD | 1 | $5 |
| BUNDLE | $20 USD | 5 | $4 (20% off) |

**It's a one-time purchase.** Not a subscription. Once you buy, there are no further charges.

### How to buy

1. App menu → "Buy eggs…" opens your browser (or go to aic0t.com directly)
2. Sign in with Google or email
3. Choose a quantity and continue to Stripe Checkout
4. Once payment goes through, the eggs arrive in your Hatch Tray

Card / Apple Pay / Google Pay / Link are supported. Stripe handles payment; we never hold your card details. Receipts are emailed automatically.

### When it shows up

After payment completes, eggs arrive right away if the app is running. If it isn't, they'll be in the Hatch Tray the next time you launch it.

### About premium eggs

Children born from purchased eggs start with slightly higher first-generation base stats (initial maximum HP and immunity). Very rarely, one is born in a limited color.

**This isn't Pay to Win.** You can't specify what form they'll take. That's for how you raise them to decide.

### Refunds

You can apply within **7 days** of purchase if the eggs covered by the request have not been hatched or used. If only part of a BUNDLE remains unused, we can review a partial refund for that unused portion. Please reach out through the contact form.

This policy does not limit any rights you may have under applicable law.

---

## 11. Privacy and data

### What runs locally

- Voice transcription (fully offline on macOS)
- AI processing when you choose the Apple on-device LLM or llama.cpp
- Reading and writing save data

Save data is stored locally, **encrypted with AES-256-GCM**. Character images and data live in encrypted containers too, and are only ever decrypted in memory.

### What leaves your machine

- **If you configure an OpenAI-compatible API**: whatever is passed to the AI is sent to the endpoint you specify
- **If you enable Deep Context**: the active app name, window title, and selected text are used as hints for the AI. Turn it off and none of that is collected
- **AI tagging and summarizing for bookmarks**: page contents are passed to the AI
- **RSS reader**: connects out to fetch feeds
- **Cloud sync**: everything under "What gets synced" above
- With the Claude integration (MCP) enabled: condition, mood and similar state, plus the body of any memo you asked it to read or write, are passed to Claude. The contents, image data and full path of a file opened in the previewer are not

**The AI runs locally by default.** Cloud integrations are opt-in and only enabled when you explicitly turn them on.

**Consultation conversations are not saved.** They're cleared from memory when the session ends.

### Where data is stored

- **macOS**: `~/Library/Application Support/AICoach/`
- **Windows**: `%LOCALAPPDATA%\AICoach\`

Cloud-side data is stored in the Tokyo region (`asia-northeast1`), and can't be read or written by anyone outside your own account.

### Erasing your records

You can erase everything. Every life you raised, every lineage, the whole Encyclopedia — all lost, back to the first empty margins. **This can't be undone.**

### Sharing with third parties

**We don't sell it. We don't hand it over.** Your raising records, your memos and your transcriptions are
never sold, lent or otherwise given to a third party. There is no collection for advertising and no
third-party tracker embedded anywhere.

The only things that leave your machine are the routes listed under "What leaves your machine" above —
each one something you turned on yourself.

| Who | What for | Your choice |
|---|---|---|
| The OpenAI-compatible endpoint you configured | AI processing | Only when you enable it explicitly |
| Google Firebase (Tokyo region) | Cloud sync | Only when you sign in |
| Stripe | Payment for an egg | Only when you buy one |
| Claude (MCP integration) | The action you asked for | Only when you enable the integration |

Except where we are required to disclose by law.

### How long things are kept

| What | How long |
|---|---|
| Save data (raising, lineage, encyclopedia) | Stays on your machine until you erase it |
| Memos | Stay until you erase them. Deleting moves the file to your OS trash |
| Consultation conversations | **Not stored.** They leave memory when the session ends |
| Voice input audio | **Not stored.** Discarded once it becomes text |
| The Claude integration's activity display | Clears itself after 15 minutes at most |
| Cloud sync data | For as long as the account exists. Closing it deletes the data |

Uninstalling the app does not erase the folders above. To clear everything, run "Erase your records" or
delete those folders yourself.

### Contact

For questions about privacy and how data is handled, use the contact form on the site or write to
contact.aicoach@gmail.com.

---

## 12. Supported languages

Five languages are supported: 日本語 / English / 简体中文 / 繁體中文 / Español.

The display language is chosen automatically to match **your OS system language**.

- **macOS**: System Settings → Language & Region
- **Windows**: Settings → Time & language → Language

On systems set to an unsupported language, the app displays in English.

---

## 13. System requirements

| | macOS | Windows |
|---|---|---|
| OS | macOS 26 or later | Windows 10 / 11 |
| Recommended | Latest macOS | Windows 11 |
| CPU | Apple Silicon | x64 |
| Framework | Swift 6.2 / AppKit | C++ / WinUI 3 |

Some features require an internet connection. Sync uses Firebase. The macOS version is Apple Silicon only. The Windows version is in development and coming soon; it is not distributed yet.

### Differences between the macOS and Windows versions

These features aren't available on Windows yet. We're working through them.

- Consultation
- Account linking and cloud sync
- Shortcut keys for clipboard history, bookmarks, and RSS (they're still available from the menu)
- AI image generation
- Some visual scenes

---

## 14. If something goes wrong

**My character isn't showing up**
Open "Character management" from the menu bar (macOS) or task tray (Windows) and check whether they've been put away. Ghosts can be called back from the put-away list too.

**My egg won't hatch**
Eggs hatch on time alone. No feeding needed. Time doesn't pass while they're put away, so leave the egg out on screen and wait.

**Voice input isn't responding**
1. If it's still an egg, voice input isn't unlocked yet (by design)
2. Check that microphone permission is granted
3. Check that you're holding Right-Shift for **0.3 seconds or more** (a short tap won't trigger it)
4. Check that no other app has claimed Right-Shift

**Transcription results aren't going into other apps**
Auto-typing requires Accessibility permission — grant it in settings. Also check that the auto-typing setting is turned on.

**The AI isn't responding**
Check your endpoint and model name in AI Settings. If you're using llama.cpp, the context length needs to be 8192 or more. When there's no response, the app automatically switches to ordinary lines.

**The eggs I bought haven't arrived**
Restart the app and check the Hatch Tray. If they still aren't there, contact us and include the email address you used for the purchase.

**My data isn't carrying over to another device**
Check that both devices are signed in to the same Google / email account. Sync becomes active on accounts that have purchased at least one egg.

**The illness won't clear up**
"Nurse" is effective once per hour. With high immunity, they recover naturally. Keep them fed and let them sleep properly.

**Claude can't find AI Coach**
Check that AI Coach is running and that the integration is enabled. Connection details are rebuilt on every app launch, so restarting AI Coach once often fixes it.

**I asked Claude, but nothing happened**
Nothing is shown on a sleeping character, an egg, a ghost, or one that's put away — and the same goes for during consultation, conversation, or transcription. Bring another character out and try again. If only the hopping is missing, check that "bounce effects" isn't turned off in settings.

**The "working" display is stuck on screen**
It clears itself after 15 minutes at most. To clear it sooner, tell Claude the work is over, or put that character away once.

---

## Contact

If this didn't solve it, please reach out through the contact form on the site.
The FAQ is worth a look too.

## よくある質問

出典: https://aic0t.com/#help

### 複数の端末で使えますか？

ライセンスキーや台数制限はありません。卵の在庫と育成データは AI Coach アカウント（UID）に紐づくので、同じ Google／メールアカウントでサインインすれば別の端末でも続きから使えます。

ただしクラウド同期が有効になるのは、卵を 1 個以上購入したアカウントだけです。同梱の卵だけで遊んでいる場合、データはその端末の中にとどまります。

### キャラクターが死んでしまったらどうなりますか？

メイン機能（音声文字起こし・AI・便利ツール）はそのままご利用いただけます。デスクトップが少し寂しくなるだけです。新しい卵をご購入いただくと、また新しい子をお迎えできます。

### 返金の対象になる条件を教えてください

購入から7日以内、かつ返金対象の卵をまだ孵化（育成開始）していない場合に申請できます。あわせて、Stripe の購入完了画面・領収書メールに記載された注文番号（Order reference）のご記入が必須です。実際にご購入いただいたことを確認するための条件で、記載がない場合はご購入を確認できないため、スパムとみなして返金に応じられないことがありますのでご了承ください。BUNDLE の一部だけが未使用の場合は、その未使用分の一部返金も確認します。

このポリシーは、適用される法令上の権利を制限するものではありません。

### 法人で複数ライセンスを購入したいのですが？

お問い合わせフォームより「法人ライセンスについて」とご連絡ください。ボリュームディスカウントと請求書払いに対応しております。

### AIはどこで動いていますか？

基本はローカルで動作します。クラウド連携はオプトイン方式で、設定で明示的に有効化したときのみ有効になります。

### これはサブスクリプションですか？

いいえ、買い切り型です。一度ご購入いただければ、追加料金なしでずっとお使いいただけます。

### どこかで見たことがある気がするのですが？

それは……30年前の、でしょうか！？ ルーツは同じかもしれません。あの頃の「机の上で何かが生きている」感覚を忘れずに、現代のAIで進化させたのがこの子たちです。

### Windows版はいつリリースされますか？

もう少しお時間をいただきます。準備が整いしだい、このページにてお知らせいたします。

### YouTubeなどで紹介してもよいですか？

もちろん大歓迎です。実況・レビュー・配信・切り抜きなど、どのような形でもご自由にご紹介いただけます。収益化も問題ありません。ハッシュタグ #aic0t を付けていただけると見つけやすく、公式アカウントからご紹介させていただく場合もあります。素敵な動画を楽しみにしております。

### 使える決済方法と、最終的な請求額はどこで確認できますか？

利用できるカードや決済方法は、Stripe Checkout に表示されるものをご利用いただけます。対応方法は国・地域・端末によって異なる場合があります。

税、現地通貨への換算、カード会社の海外事務手数料などがある場合は、支払い確定前の Stripe 画面とカード会社の条件をご確認ください。Stripe 画面を開いただけでは請求されません。

### カードが拒否され、決済できません

まずカード番号、有効期限、CVC、請求先情報を確認し、Stripe 画面でもう一度お試しください。解決しない場合は別の決済方法を使うか、カード会社へお問い合わせください。カード会社は安全上の理由から、拒否理由を当社や Stripe に詳しく伝えない場合があります。

失敗した決済には領収書は発行されません。短時間に何度も確定ボタンを押さず、購入履歴とメールを確認してから再試行してください。

### Stripe の画面を閉じた、または購入をキャンセルした場合は請求されますか？

支払いを確定する前に画面を閉じたりキャンセルした場合、購入は成立しません。決済完了後に画面を閉じた場合は処理が完了していることがあるため、Stripe の領収書メールと「購入履歴」を確認してください。

カード明細に一時的な「保留」「未確定」が見える場合は、カード会社によるオーソリ（利用枠の一時確保）の可能性があります。確定請求になったまま商品が反映されない場合は、再購入せずお問い合わせください。

### 支払いは完了したのに、卵が在庫に反映されません

二重購入を避けるため、まず再購入はしないでください。Stripe の領収書メールが届いていることを確認し、購入時と同じ AI Coach アカウントでログインしているか確認してください。その後、ページの再読み込みとアプリの再起動をお試しください。

数分待っても反映されない場合は、購入メールアドレス・購入日時・プラン／金額・領収書番号を添えてお問い合わせください。カード番号全桁や CVC は不要です。

### 二重請求、または身に覚えのない請求があります

まず明細の「確定」と「保留」を見分け、Stripe の領収書メールと購入履歴を照合してください。保留中の表示は、後日自動で取り消される場合があります。

同額の確定請求が2件ある、または購入に心当たりがない場合は、明細の日付・金額・通貨・カード下4桁を添えて直ちにお問い合わせください。カード番号全桁や CVC は送らないでください。不正利用が疑われる場合は、カード会社にも速やかに連絡してください。

### 領収書はどこで確認できますか？再送できますか？

決済が成功すると、Stripe から購入時のメールアドレスへ領収書が送信されます。「Stripe」「AI Coach」で検索し、迷惑メールフォルダもご確認ください。失敗・拒否された決済には領収書は発行されません。

見つからない場合は、購入日・金額・購入に使ったメールアドレスを添えてお問い合わせください。確認後、領収書の再送をご案内します。

### 返金はどのように申請すればよいですか？

この画面下部の「返金を申請する」からお問い合わせフォームを開き、Stripe の注文番号（Order reference・必須）、購入時のメールアドレス、購入日、プラン／金額、返金希望数、理由を送信してください。申請内容と未使用状態を確認後、受付結果をご連絡します。

注文番号は Stripe の購入完了画面と領収書メールに記載されています。注文番号のない申請はご購入を確認できないため、スパムとみなして返金に応じられないことがあります。返金の実行者は販売元である当社です。Stripe へ直接連絡しても当社に代わって返金はできません。カード番号全桁や CVC は絶対に送信しないでください。

### 返金はどこに戻り、いつ確認できますか？

返金は、購入時に使用したカードまたは決済手段へ同じ通貨で行われ、別のカード・口座・通貨へ変更することはできません。Stripe で処理後、通常は5〜10営業日で明細に反映されますが、金融機関によっては最大30日かかる場合があります。

購入直後の返金は、返金の入金行ではなく元の請求が消える「取消」として表示されることがあります。10営業日を過ぎても元の請求が残り返金を確認できない場合は、追跡用の照会番号を確認しますのでお問い合わせください。

### BUNDLE の一部だけを返金できますか？

購入から7日以内で、BUNDLE に含まれる卵の一部が未使用・未孵化の場合は、その未使用分について一部返金を確認します。返金額の合計が元の購入額を超えることはありません。承認時に、返金対象と今後の在庫の取り扱いを個別にご案内します。すでに孵化（育成開始）した分は返金対象外です。

### 購入した卵は、どのアカウントに紐づきますか？

購入ボタンを押した時点でログインしている AI Coach アカウント（UID）に紐づきます。カード名義や、Stripe 画面で入力したメールアドレスだけで紐づけ先が変わることはありません。

アプリでも同じ Google／メールアカウントでログインしてください。別のアカウントで購入した可能性がある場合は、再購入せずお問い合わせください。

### 卵のうちは、音声入力や便利機能が使えないのですか？

はい。卵の間は、音声入力・クリップボード履歴・ブックマーク・RSS リーダー・占いといった機能はまだ解放されません。孵化して赤ちゃんになった時点から、成長にあわせて順に使えるようになります。

卵は世話をしなくても、時間が経つだけで孵ります（目安は 1 時間ほど。アプリを閉じている間の時間も進みます）。これは仕様上の制限で、不具合ではありません。