Claudiator is a multi-device Claude Code session orchestration assistance. It combines a Rust-powered server, a lightweight CLI hook, and a native iOS app to give you real-time push notifications and a unified view of all your Claude Code sessions across every machine you work on.

Claudiator iOS app - Devices view showing connected machines and active session counts

Claudiator iOS app - Sessions view showing aggregated Claude Code sessions

Claudiator iOS app - Settings view with theme customization options

Installation & Downloads

Claudiator has three components: a CLI hook that runs on each machine alongside Claude Code, a server that aggregates sessions, and an iOS app for monitoring and notifications. Download the latest versions below, or view all releases on the release page:

CLI Hook: Install on each machine running Claude Code
Quick install (auto-detects OS/arch, configures hooks):
```
curl -fsSL https://raw.githubusercontent.com/ShahadIshraq/claudiator/main/hook/scripts/install.sh | bash
```
Quick update:
```
~/.claude/claudiator/update.sh
```
Loading latest release...
Server: Central session aggregator (Linux, requires root/sudo)
Quick install (sets up systemd service, config, and APNs):
```
curl -fsSL https://raw.githubusercontent.com/ShahadIshraq/claudiator/main/server/scripts/install.sh | sudo bash
```
Quick update:
```
sudo /opt/claudiator/update.sh
```
Loading latest release...
iOS App: Coming soon on the App Store

Push Notifications: The iOS app's push notifications are tied to my server's APNs configuration. To use them, you can either build the app from source with your own APNs setup, or reach out to me and I can help set up a dedicated server that you control while ensuring your data stays private and secure.

For detailed setup instructions, configuration guides, and API documentation, visit the GitHub repository.

Key Features

📱

Multi-Device Monitoring

See all devices with active session counts and status at a glance

🔗

Cross-Device Sessions

Aggregated view of sessions across all your machines in one place

🔔

Real-Time Push Notifications

APNs push with polling fallback — never miss a permission prompt

🔒

Privacy-First Design

Only 7 fields sent to the server; sensitive data stays on your machine

🎨

Customizable Themes

4 built-in themes: Standard, Neon Ops, Solarized, and Arctic

⚡

Lightweight Hook

~2MB CLI binary that never blocks Claude Code with a 3-second timeout

Technical Architecture

iOS App

The iOS app is built with pure SwiftUI using MVVM architecture with @Observable. It stores credentials securely in the Keychain and integrates with APNs for real-time push notifications. The app provides device monitoring, session aggregation, and customizable theming.

Pure SwiftUI with MVVM and @Observable pattern
Secure credential storage via Keychain
APNs integration for real-time push notifications
4 built-in color themes with live preview

Server

The server is built in Rust using Axum with SQLite in WAL mode for high-concurrency reads. It handles Bearer token authentication, device registration, session tracking, and sends push notifications via APNs using ES256 JWT signing.

Rust with Axum web framework
SQLite with WAL mode for concurrent access
Bearer token authentication
APNs push notifications with ES256 JWT

CLI Hook

The CLI hook is a lightweight Rust binary that integrates with Claude Code's hook system. It uses ureq for HTTP requests, reads configuration from a TOML file, and includes file-based logging. With a 3-second timeout and always-exit-0 design, it never blocks your Claude Code workflow.

Lightweight ~2MB Rust binary
TOML-based configuration
File-based logging for debugging
3-second timeout, always exits 0

Contribute

If you find Claudiator useful, please consider contributing with ideas, suggestions or code contributions. Check out the GitHub repository for more information.

← Back to Projects Privacy Policy