v1.0.0 — Noober iOS SDK

Noober iOS SDK v1.0.0

In-app debugging SDK that gives AI agents deep visibility into your iOS app.

Quick Start

// Package.swift
.package(url: "https://github.com/noob-programmer1/Noober-iOS", from: "1.0.0")

// App init
#if DEBUG
import Noober
Noober.shared.start()
#endif

What it exposes to AI agents (via NooberMCP)

• Network requests/responses (URLSession + WebView)
• WebSocket frames
• App logs
• UserDefaults / Keychain
• Environment switching
• Mock & intercept rules
• Screen layout as HTML
• Accessibility tree
• Flow recording & replay
• In-process tap/swipe (TouchSynthesizer)

Communication

TCP companion server on port 54321 with 4-byte length-prefix framing.
NooberMCP connects here to read app data and send commands.

Requirements

• iOS 17+
• macOS 14+ (for companion)
• Swift 5.9+

Noober 2.0.0

Noober 2.0.0

Complete rewrite of the Noober debugging toolkit for iOS.

What's New

Network Inspector

• Automatic HTTP/HTTPS request capture via URLProtocol
• WebSocket connection and frame monitoring
• cURL export, request replay, image preview
• Screen tracking — see which view controller triggered each request
• Search and filter by method, status, host, content type, screen

Rules Engine

• URL Rewrite — redirect requests to different hosts (5 match modes: Host, Contains, Prefix, Exact, Regex)
• Mock Rules — return synthetic responses without hitting the network
• Intercept Rules — pause requests mid-flight, inspect/edit, then proceed or cancel

Environment Switching

• Register named environments with base URLs
• One-tap switching with automatic URL rewriting
• Multi-URL positional mapping for apps with multiple backends
• Persists active selection across launches

QA Checklist

• Register test items with title, notes, priority, and endpoints
• Track pass/fail per build number
• Attach network requests to failed items
• Auto-resets on new builds

Storage Inspector

• Browse and edit UserDefaults (type-aware editing, JSON export)
• Browse and manage Keychain items (generic + internet passwords)
• App info view

Custom Logging

• Structured logs with levels (debug/info/warning/error) and custom categories
• Thread-safe — call from any thread
• Source file and line captured automatically

Floating Bubble UI

• Draggable overlay bubble with edge snapping
• Live request count badge and pulse animations
• 5-tab debug panel: Network, Storage, Logs, Rules, QA

Requirements

• iOS 15.0+
• Swift 6.0+
• Xcode 16+

Installation (SPM)

.package(url: "https://github.com/noob-programmer1/Noober-iOS.git", from: "2.0.0")

v1.0.0

Initial Release