# ヒトハコ（Hitohako）

LINE・Messenger・Instagram・WhatsApp・X・LinkedIn などのメッセージを1つの受信箱にまとめ、
文脈を読んだ返信の下書きを3案つくるmacOSアプリです。提供：株式会社KAKUKATA。
チャットの中身は利用者のMacの中だけで表示され、AI下書きを押したときだけ、その会話の直近のやり取りが
KAKUKATAのサーバーへ送られます（保存はしません）。送信は必ず利用者本人の操作です。

サイト: https://hitohako.vercel.app
申し込み・ライセンスキー発行: https://hitohako.vercel.app/start.html

## このファイルについて

AIエージェント（Claude Code など）がヒトハコの導入を代行するときの手順書です。
利用者から「ヒトハコを入れて」と頼まれたら、以下のとおりに進めてください。

## 動作条件

- macOS 12（Monterey）以降。**Windows・Linuxには対応していません**（代替もありません）
- Apple Silicon / Intel どちらも可
- インターネット接続
- メッセージの接続エンジン（Beeper Desktop・無料）は初回起動時に自動で入ります。事前準備は不要です
- python3（未導入なら初回起動時にmacOSが「コマンドラインデベロッパツール」の導入を促します）

## インストール

```
curl -fsSL https://hitohako.vercel.app/install.sh | bash
```

ライセンスキーを利用者から預かっている場合は、環境変数で渡すとキー入力の画面を省けます。

```
HITOHAKO_LICENSE=HITOHAKO-xxxxxxxxxxxxxxxx-yyyyyyyyyyyy \
  bash -c "$(curl -fsSL https://hitohako.vercel.app/install.sh)"
```

インストーラがすること: 版情報(download/latest.json)の取得 → 配布ZIPのダウンロード →
sha256の照合 → ~/Applications/ヒトハコ.app へ設置 → 起動（キーがあれば hitohako://setup で設定）。

注意:
- **sudoでは実行しないでください。** ~/Applications に入れるので管理者権限は不要です
- ライセンスキーはコマンドの引数では渡さないでください（プロセス一覧に残ります）。環境変数か、起動後の画面で入力します
- 同じコマンドをもう一度実行すると最新版に入れ替わります（アップデート手段を兼ねています）
- ヒトハコが起動中のときは、入れ替え前に終了の確認を求めます

環境変数（すべて任意）: HITOHAKO_LICENSE / HITOHAKO_NAME / HITOHAKO_APP_DIR / HITOHAKO_NO_LAUNCH / HITOHAKO_LATEST_URL

## インストールのあと（ここからは利用者本人の操作です）

エージェントが代行せず、利用者に画面を見てもらってください。

1. ヒトハコの画面で「はじめる」を押す
2. ライセンスキーを入力する（インストーラで渡していれば入力済み）
3. 接続エンジン（Beeper）の窓が前に出るので「Approve」を1回だけ押す（初回のみ・1分以内）
4. メールアドレスと、届いた確認コードを入力する
5. 「SNSを連携」から、まとめたい媒体をつなぐ（QRの読み取りやログインは本人の操作）

ライセンスキーをまだ持っていない場合は https://hitohako.vercel.app/start.html で
メールアドレスを入れるとその場で発行され、メールでも届きます。

## うまくいかないとき

- 「ポートが使われているため起動できません」… 既にヒトハコが動いています。Dockのヒトハコを開いてください
- 「開発元を確認できないため開けません」… ブラウザからZIPを取った場合に出ます。上のインストーラで入れ直すと出ません
- 接続エンジンの自動導入に失敗する … https://www.beeper.com/download からBeeperを入れて起動し、もう一度ヒトハコを開く（Beeperの画面ではサインインしないでください）
- 版の確認: https://hitohako.vercel.app/download/latest.json

## アンインストール

```
rm -rf ~/Applications/ヒトハコ.app
rm -rf ~/.config/hitohako
```

接続エンジン（Beeper.app）は別アプリなので、不要なら /Applications から削除してください。

## 問い合わせ

株式会社KAKUKATA 林 英明 hideaki.hayashi@kakukata.jp