Repository navigation
Install / update
curl -fsSL https://raw.githubusercontent.com/kimikr/peek/main/scripts/install.sh | sh
peek doctor
On the phone, install Peek-0.3.0.ipa with SideStore or AltStore, or add it to LiveContainer. Check it with sha256sum -c Peek-0.3.0.ipa.sha256. The 0.2 app still talks to this script (same protocol), but the menu's "Erase saved data and quit" needs the 0.3.0 app.
Everything below was checked on an iPhone (iOS 27, Peek inside LiveContainer), with real apps: MensaDresden, bev17 and a SwiftData app opened from its .xcodeproj.
New
- Tests on the phone: XCUITest.
peek testnow runs UI tests too: taps, typing, swipes, pinch, rotation, system alerts, launch arguments and environment, and other apps (launch, activate, terminate).--onceexits with the result,--junit FILEwrites a report,--filterpicks tests. A failing UI test prints the app's element tree. - Xcode projects.
peek dev App.xcodeproj(or its folder) builds the app target as a package: classic groups and Xcode 16 folders, Swift package products, local packages, the Debug Swift settings, and unit and UI test targets forpeek test. - SwiftData.
@Model,@Query,#Predicate,@Attribute,@Relationship,@Transient,#Unique,#Indexand@ModelActorbuild on Linux: peek ships its own SwiftData macros and builds them once. Each project gets a store of its own; the Peek menu erases it. - Asset catalogs are compiled to
Assets.car, dark and @1x/@2x/@3x variants included, also inside dependencies, by peek's ownactool(built on AssetKit). - Breakpoints.
// peek:break a, b.countstops the app at that line and shows the values and call stack on the phone;// peek:log a, bprints them. - Languages.
peek dev --language deshows the app's strings in another language, right to left for Arabic and Hebrew. - Your app's
Bundle.main. ItsInfo.plistkeys and the resources it reads from the main bundle (url(forResource:),UIImage(named:)with any name) come from your app. - Crashes print their call stack, for Objective-C exceptions and for crashes such as a Swift runtime trap.
Fixes
Text("key")and SwiftGen strings show translations instead of keys;SWIFT_PACKAGEis defined like SwiftPM does.- Sources in a linked folder, asset names with non-ASCII letters,
struct App: SwiftUI.App,@main @MainActor struct …, and#Previewinside#ifbuild. - Projects whose default actor isolation is MainActor build with all of the above.
- A failed signing no longer leaves an unsigned library that was served from then on; certificate installs are atomic.
- The server refuses badly signed requests before reading their body, drops idle clients and caps concurrent requests. Two
peekruns on one project no longer share a build folder.
Known limits
- A dependency (not the previewed target) with a string catalog can't be built on Linux (SwiftPM cannot be told the strings' encoding there).
@Attribute(.transformable(by:))with a transformer class of your own crashes inside SwiftData.- With
--language, dates and numbers keep the phone's format and plurals show their "other" form. - Log output from the phone is signed but not encrypted, and replies are not yet bound to their requests. Both change with the next protocol version.