Claudiator

Claudiator

Orchestrate Claude Code sessions across all your devices.

Claudiator is a lightweight system that captures Claude Code hook events and forwards them to a server, giving you a unified view of all your parallel agent sessions across devices. Track what's running where, know which sessions need input, and orchestrate your Claude Code work across multiple machines.

Components

- claudiator-hook — A Rust CLI binary that runs as a Claude Code hook. It reads hook events from stdin and POSTs them to the Claudiator server.
- Claudiator Server — Stores events, manages devices, serves the REST API, and sends push notifications directly to APNs.
- Claudiator iOS App — A SwiftUI app for monitoring sessions, viewing event timelines, and receiving real-time push notifications via APNs. See ios/README.md.

How It Works

1. Claude Code fires hook events (SessionStart, SessionEnd, Stop, Notification, PromptSubmit)
2. claudiator-hook reads the JSON event from stdin, wraps it with device info, and POSTs it to the server
3. The server stores the event and makes it available to the mobile app
4. The server sends push notifications to your iOS device when sessions need attention (stopped, waiting for permission, idle)
5. You see all active sessions across devices in the iOS app and orchestrate parallel agent work

HTTP Hooks (Direct)

Claude Code can POST hook events directly over HTTP (no local hook binary). Claudiator supports this via POST /api/v1/hooks/http, which accepts the raw hook JSON and uses headers for device identity. See server/API.md and hook/README.md for the exact payload and headers.

Migration: Stdin Hook → HTTP Hook

1. Re-run the hook installer and choose http when prompted for hook transport:
   - macOS/Linux: hook/scripts/install.sh
   - Windows:…