English · 한국어

https://github.com/user-attachments/assets/1f2cda8f-da85-492a-ac19-24ed8d34d778] [T0]] [T0]] [T0]] [T0]] [T0]] [T0]] [T0]] [T0] [T0] [T0]] [T0] [T0] [T0]] [T0]] [T0] [T0] [T0] [T0] [T0]] [T0] [T0]] [T0] [T0] [T0]] [T0]] [T0] [T0] [T0]] https://github.com/user-attachments/assets/1f2cda8f-da85-492a-ac19-24ed8d34d778] https://github.com/user-attachments/assets/1f2cda8f-da85-492a-ac19-24ed8d34d778]]] https://github.com/user-attachments/assets/1f2cda8f-da85-492a-ac19-24ed8d34d778]]]]]] [[https://github.com/user-attachments/assets/1f2cda8f-da85-492a-ac19-24ed8d34d778]]]]]]] [[[[[[https://github.com/user-attachments/assets/1f2cda8f-da85-492a-ac19-24ed8d34d778]]]]]]]]]]]]]] [[[[[[[https://github.com/user-attachments/assets/1f2cda8f-da85-492a-ac19-24ed8d34d778]]]]]]]]]]]]]]]]]] [[[[[[[[[[[[[[[[[[[[[[

A DEBUG-only iOS SDK는 browsable debug 대상으로 앱을 전환합니다. 통합, 호출 start(), 그리고 같은 네트워크의 브라우저에서 당신은 얻을:

• S **Sandbox 파일 브라우저 ** - 목록 / 미리보기 / 편집 / 다운로드 / 삭제, 범위 스트리밍, 루트 정의 (live)
• Live Network Capture** - 모든 URLSession] 요청, 실시간 검사 (live)
• **Database 뷰어 ** - SQLite DB를 발견, 테이블/schema를 검색, 읽기 전용 SQL 실행 (live; Core Data/Realm + 나중에 작성)
• 知Live logs — 앱의 콘솔 출력(SandboxServer.log]], plus print]/NSLog]] when console Capture is on) 브라우저, 레벨 필터링 (live)
• 安卓Screen mirror + control — 브라우저에서 앱의 UI 라이브를 보고 드라이브: 탭 (UIControls / SwiftUI 버튼), swipe/scroll & 드래그 (실내 합성 터치), 유형 및 붙여넣기 (live, iOS)
• OKO ** hierarchy** — 라이브 뷰 트리 (프레임, 클래스, 라벨, 썸네일) 목록 또는 **3D 레이어 탐색기 ** 브라우저에서 (live, iOS)

SandboxServer

English · 简体中文

https://github.com/user-attachments/assets/1f2cda8f-da85-492a-ac19-24ed8d34d778

A DEBUG-only iOS SDK that turns any app into a browsable debug target. Integrate it, call start(), and from a browser on the same network you get:

• 🗂 Sandbox file browser — list / preview / edit / download / delete, Range streaming, root-confined (live)
• 🌐 Live network capture — every URLSession request, inspectable in real time (live)
• 🗄 Database viewer — discover SQLite DBs, browse tables/schema, run read-only SQL (live; Core Data/Realm + writes later)
• 📜 Live logs — stream the app’s console output (SandboxServer.log, plus print/NSLog when console capture is on) to the browser, level-filtered (live)
• 📱 Screen mirror + control — watch the app’s UI live in the browser and drive it: tap (UIControls / SwiftUI buttons), swipe/scroll & drag (real synthesized touch), type, and paste (live, iOS)
• 🌳 View hierarchy — inspect the live view tree (frames, classes, labels, thumbnails) as a list or a 3D layer explorer in the browser (live, iOS)
• 🔌 WebSocket capture — every URLSessionWebSocketTask connection and its sent/received frames, streamed live (live)
• 📈 Performance HUD — live FPS / CPU / memory footprint / thermal state, streamed and charted (live)
• 📦 App bundle inspector — Info.plist, Mach-O architectures + hardening, provisioning, privacy, plist decode (live)
• ⚙️ UserDefaults editor — browse, edit, delete & reset the app’s persisted defaults and App Group suites (live)
• 📲 Device info — model / OS / locale / screen + safe-area / battery / memory / free disk at a glance (live)
• ⛓️ Deep-link trigger — list the app’s URL schemes and open any scheme / universal link in the app (live, iOS)
• 🔔 Notification tester — inspect/request authorization, fire local notifications, simulate a remote push payload (live, iOS)
• 🖥 A web console served by the SDK itself — no app to install, just open a URL
• 🤖 MCP tools — the same on-device API re-exposed to AI clients (Claude Code / Desktop)

It runs an embedded HTTP + WebSocket server inside the host process on Apple’s Network.framework, with zero third-party runtime dependencies.

⚠️ This SDK exposes full read/write access to the host app’s sandbox. It is off by default, requires an explicit start(), binds loopback by default, and is physically absent from Release/App Store builds. Token auth is opt-in; if you bind to .localNetwork without enabling it, every device on the trusted LAN can reach the console. Use non-production accounts on a trusted network.

---

Architecture

┌─ host iOS app (DEBUG) ──────────────────────────────┐
│  SandboxServer.shared.start()                        │
│     │                                                │