Files
zooqueen adffda08b6 chore: bump version to 2026.3.5
Update version across all platforms:
- package.json: 2026.3.5
- Android: versionName 2026.3.5, versionCode 202603050
- iOS: CFBundleShortVersionString 2026.3.5, CFBundleVersion 20260305
- macOS: CFBundleShortVersionString 2026.3.5, CFBundleVersion 202603050
2026-03-05 13:48:33 -08:00
..
2026-03-05 13:48:33 -08:00
2026-03-05 13:48:33 -08:00

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)

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.