bot/apps/ios/README.md

Hanzo Bot (iOS)

This is an alpha iOS app that connects to an Hanzo Bot Gateway as a role: node.

Expect rough edges:

• UI and onboarding are changing quickly.
• Background behavior is not stable yet (foreground app is the supported mode right now).
• Permissions are opt-in and the app should be treated as sensitive while we harden it.

What It Does

• Connects to a Gateway over ws:// / wss://
• Pairs a new device (approved from your bot)
• Exposes phone services as node commands (camera, location, photos, calendar, reminders, etc; gated by iOS permissions)
• Provides Talk + Chat surfaces (alpha)

Pairing (Recommended Flow)

If your Gateway has the device-pair plugin installed:

1. In Telegram, message your bot: /pair
2. Copy the setup code message
3. On iOS: Hanzo Bot → Settings → Gateway → paste setup code → Connect
4. Back in Telegram: /pair approve

Build And Run

Prereqs:

• Xcode (current stable)
• pnpm
• xcodegen

From the repo root:

pnpm install
pnpm ios:open

Then in Xcode:

1. Select the Hanzo Bot scheme
2. Select a simulator or a connected device
3. Run

If you're using a personal Apple Development team, you may need to change the bundle identifier in Xcode to a unique value so signing succeeds.

Build From CLI

pnpm ios:build

Tests

cd apps/ios
xcodegen generate
xcodebuild test -project Hanzo Bot.xcodeproj -scheme Hanzo Bot -destination "platform=iOS Simulator,name=iPhone 17"

Shared Code

• apps/shared/Hanzo BotKit contains the shared transport/types used by the iOS app.