Sentō corre en macOS, con un detalle: macOS no tiene systemd ni una sesión persistente de cron por usuario como Linux, así que el agente sólo corre mientras tu Mac está prendida y lo lanzaste vos. Para cualquier cosa que necesite uptime 24/7, usá un VPS o Docker.

macOS es el único host que soporta el canal iMessage, ya que iMessage requiere acceso local a la base de datos de Mensajes.

Requisitos previos

  • macOS 13 (Ventura) o superior
  • Node 20+ (brew install node o nodejs.org)
  • Una suscripción a Claude (Pro o Max) — la autenticación pasa durante la instalación

Instalar

npx sentoagent init

Mismo flujo que la instalación en VPS. El instalador detecta macOS y se saltea los pasos específicos de persistencia con cron de Linux.

Setup específico de iMessage

Si elegís iMessage como canal, además tenés que darle Acceso Total al Disco a tu terminal:

  1. Configuración del Sistema → Privacidad y Seguridad → Acceso Total al Disco
  2. Click +, navegá a Aplicaciones → Utilidades → Terminal (o iTerm, Warp, Ghostty — la que uses)
  3. Activalo ON
  4. Reiniciá tu terminal

Sin esto, Sentō no puede leer ~/Library/Messages/chat.db y el agente de iMessage no puede recibir mensajes.

Después de instalar

El agente corre en una sesión tmux. Para chequearlo:

tmux attach -t <nombre-del-agente>

Ctrl-b d para soltarla, sento status para chequear desde afuera.

Reiniciar después de reboot

macOS no reinicia el agente solo. Después de un reboot, corré:

sento start

O armate un script en ~/Library/LaunchAgents/ con un plist launchd si querés autostart completo — no viene por defecto.

Uso en desarrollo

macOS es el entorno más fácil para desarrollar Sentō (contribuir, probar patches de plugins, etc.). Cloneá el repo y corré node bin/sento.js init desde tu checkout de desarrollo en vez de npx.