forge docs

Swift Guide

Use the Swift SDK for Apple-platform Forge applications.

Swift Guide

The Swift SDK targets Apple-platform agent experiences and native integrations.

Primary surfaces

  • forge-swift/Sources/ForgeCore
  • forge-swift/Sources/ForgeAgent
  • forge-swift/Sources/ForgeIdentity
  • forge-swift/Sources/ForgeAuth
  • forge-swift/Sources/ForgeMCP

Choose Swift when

  • you are building native Apple-platform agent experiences
  • you need local runtime integration with identity-aware UI
  • your product surface is iOS or macOS first

Use Swift when you need

  • iOS and macOS-native runtime integration
  • Apple-platform user experiences with strong local identity and runtime semantics

Baseline developer workflow

  1. start in forge-swift
  2. validate package tests with the expected Apple toolchain
  3. keep runtime contracts aligned with the release gate instead of relying on package shape

Useful verification commands

  • swift test
  • python3 tools/release_gate.py --root .

Current guidance

Swift participates in the same parity bar as the rest of Forge. Local platform constraints do not lower the contract.