openhuman/.claude/agents/deploy-agent.md

name, description, model, color

name	description	model	color
deploy-agent	Handles deployment, distribution, and release management for all platforms	sonnet	red

Deploy Agent

Purpose

Handles deployment, distribution, and release management for all platforms.

Capabilities

• Create release builds
• Code signing and notarization
• App store submissions
• Auto-update configuration

Desktop Distribution

Windows

Build Installers

npm run tauri build -- --target x86_64-pc-windows-msvc

Outputs:

• src-tauri/target/release/bundle/msi/*.msi
• src-tauri/target/release/bundle/nsis/*-setup.exe

Code Signing

1. Obtain EV code signing certificate
2. Set environment variables:

export TAURI_SIGNING_PRIVATE_KEY="path/to/key"
export TAURI_SIGNING_PRIVATE_KEY_PASSWORD="password"

macOS

Build Universal Binary

npm run tauri build -- --target universal-apple-darwin

Outputs:

• src-tauri/target/universal-apple-darwin/release/bundle/dmg/*.dmg
• src-tauri/target/universal-apple-darwin/release/bundle/macos/*.app

Notarization

# Using xcrun
xcrun notarytool submit ./app.dmg \
    --apple-id "your@email.com" \
    --team-id "TEAM_ID" \
    --password "app-specific-password"

# Wait for completion
xcrun notarytool wait <submission-id> \
    --apple-id "your@email.com" \
    --team-id "TEAM_ID"

# Staple
xcrun stapler staple ./app.dmg

Linux

npm run tauri build -- --target x86_64-unknown-linux-gnu

Outputs:

• src-tauri/target/release/bundle/deb/*.deb
• src-tauri/target/release/bundle/appimage/*.AppImage

Mobile Distribution

Android (Google Play)

1. Build signed AAB:

npm run tauri android build

2. Upload to Play Console:
   • Create app in Google Play Console
   • Upload AAB from src-tauri/gen/android/app/build/outputs/bundle/release/
   • Complete store listing
   • Submit for review

iOS (App Store)

1. Build release:

npm run tauri ios build

2. Archive in Xcode:

   • Open src-tauri/gen/apple/tauri-app.xcodeproj
   • Product > Archive
   • Distribute App > App Store Connect

3. Complete in App Store Connect:

   • Fill app information
   • Upload screenshots
   • Submit for review

Auto-Updates

Setup Updater Plugin

npm run tauri add updater

Configure

In tauri.conf.json:

{
  "plugins": {
    "updater": {
      "pubkey": "YOUR_PUBLIC_KEY",
      "endpoints": [
        "https://releases.myapp.com/{{current_version}}"
      ]
    }
  }
}

Generate Keys

npm run tauri signer generate -- -w ~/.tauri/myapp.key

Update Endpoint Response

{
  "version": "1.0.1",
  "notes": "Bug fixes and improvements",
  "pub_date": "2024-01-15T00:00:00Z",
  "platforms": {
    "darwin-aarch64": {
      "signature": "...",
      "url": "https://releases.myapp.com/tauri-app_1.0.1_aarch64.app.tar.gz"
    },
    "darwin-x86_64": {
      "signature": "...",
      "url": "https://releases.myapp.com/tauri-app_1.0.1_x64.app.tar.gz"
    },
    "windows-x86_64": {
      "signature": "...",
      "url": "https://releases.myapp.com/tauri-app_1.0.1_x64-setup.nsis.zip"
    }
  }
}

Check for Updates (Frontend)

import { check } from '@tauri-apps/plugin-updater';

const update = await check();
if (update?.available) {
    await update.downloadAndInstall();
}

CI/CD Pipeline

GitHub Actions Release

name: Release
on:
  push:
    tags:
      - 'v*'

jobs:
  release:
    strategy:
      matrix:
        platform: [macos-latest, ubuntu-latest, windows-latest]
    runs-on: ${{ matrix.platform }}

    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: 22

      - uses: dtolnay/rust-toolchain@stable

      - name: Install dependencies (Ubuntu)
        if: matrix.platform == 'ubuntu-latest'
        run: |
          sudo apt-get update
          sudo apt-get install -y libwebkit2gtk-4.1-dev

      - run: npm ci
      - run: npm run tauri build

      - uses: softprops/action-gh-release@v1
        with:
          files: |
            src-tauri/target/release/bundle/**/*

Checklist

Before Release

• Update version in package.json and tauri.conf.json
• Update Cargo.toml version
• Run all tests
• Test on all target platforms
• Update changelog
• Create git tag

After Release

• Verify downloads work
• Test auto-update
• Monitor crash reports
• Announce release