Sentō は macOS で動きますが、1 つ注意点:macOS には Linux のような systemd も永続的なユーザーレベル cron セッションもないので、エージェントは Mac が起動していて、あなたが起動したときだけ動きます。24/7 稼働が必要なものには、VPS か Docker を使ってください。
macOS は iMessage チャンネルをサポートする唯一のホストです。iMessage は Messages データベースへのローカルアクセスが必要だからです。
前提条件
- macOS 13(Ventura)以降
- Node 20+(
brew install nodeまたは nodejs.org から) - Claude サブスクリプション（Pro または Max） — 認証はセットアップ中に自動で行われます
インストール
npx sentoagent init
VPS インストールと同じフロー。インストーラが macOS を検出し、Linux 固有の cron 永続化ステップをスキップします。
iMessage 固有のセットアップ
iMessage をチャンネルに選んだ場合、ターミナルにフルディスクアクセスを与える必要もあります:
- システム設定 → プライバシーとセキュリティ → フルディスクアクセス
+をクリック、アプリケーション → ユーティリティ → ターミナル(または iTerm、Warp、Ghostty など、使っているもの)に移動- ON に切り替え
- ターミナルを再起動
これなしだと、Sentō は ~/Library/Messages/chat.db を読めず、iMessage エージェントはメッセージを受信できません。
インストール後
エージェントは tmux セッションで動きます。確認するには:
tmux attach -t <エージェント名>
Ctrl-b d でデタッチ、sento status で外から確認。
再起動後
macOS はエージェントを自動再起動しません。再起動後は:
sento start
または、完全な自動起動が欲しければ ~/Library/LaunchAgents/ で launchd の plist を自分で書く — デフォルトでは含まれません。
開発用途
macOS は Sentō 自体を開発するのに一番簡単な環境です(コントリビュート、プラグインパッチのテストなど)。repo をクローンして、npx の代わりに dev チェックアウトから node bin/sento.js init を実行。