install-ios.md

SnapKitty Sovereign Harness — iPhone & iPad

The full sovereign stack runs in your browser. No App Store. No download.

Option 1 — Safari (instant, no install)

1. Open Safari on iPhone or iPad
2. Go to: https://snapkittywest.github.io/sovereign-harness/
3. Tap Share → Add to Home Screen
4. It installs as a PWA — works offline after first load

The browser UI runs:

• Plasma Gate (7 principles, 8 prohibitions, ERE-5)
• Kneser-Ney language model (sovlm)
• ANU QRNG real quantum entropy
• WORM SHA-256 chain (local storage)
• WebLLM — runs Phi-3 Mini in your browser via WebGPU

Option 2 — Swift Playgrounds (iPad)

Open Swift Playgrounds on iPad and create a new playground with this code:

import SwiftUI
import WebKit

struct SovereignHarness: View {
    var body: some View {
        SovereignWebView()
            .ignoresSafeArea()
    }
}

struct SovereignWebView: UIViewRepresentable {
    let url = URL(string: "https://snapkittywest.github.io/sovereign-harness/")!

    func makeUIView(context: Context) -> WKWebView {
        let config = WKWebViewConfiguration()
        config.allowsInlineMediaPlayback = true
        config.mediaTypesRequiringUserActionForPlayback = []
        let wv = WKWebView(frame: .zero, configuration: config)
        wv.load(URLRequest(url: url))
        return wv
    }

    func updateUIView(_ uiView: WKWebView, context: Context) {}
}

// Run it
import PlaygroundSupport
PlaygroundPage.current.setLiveView(SovereignHarness())

This opens the full sovereign harness UI inside Swift Playgrounds — same plasma gate, same WORM chain, same WebLLM.

Option 3 — Shortcuts (iPhone automation)

1. Open the Shortcuts app
2. Create a new shortcut
3. Add action: Open URLs
4. URL: https://snapkittywest.github.io/sovereign-harness/
5. Add to home screen as "Sovereign"

What runs in the browser (no server needed)

Component	Browser version
Plasma Gate	plasma_gate.mjs — 7 principles, 8 prohibitions, ERE-5
Language model	sovlm.mjs — Kneser-Ney n-gram, zero GPU
WebLLM	@mlc-ai/web-llm — Phi-3 Mini via WebGPU
Quantum entropy	quantum.mjs — ANU QRNG + CSPRNG fallback
WORM chain	worm.mjs — SHA-256 sealed, localStorage
pocketlearn	pocketlearn.mjs — ILP co-occurrence in browser
git-command-center	gitdos.js — full git DOS terminal

Ω = TRUST ∧ CODE