Wormholy
A zero-code iOS network debugging library that records and inspects all URLSession traffic via shake gesture.
What is Wormholy?
Wormholy is an iOS debugging library that automatically records and inspects all network traffic made through URLSession without requiring any code changes. It solves the problem of tedious network debugging by providing instant access to request/response details through a simple shake gesture, making it easier to identify and fix API issues.
iOS developers working with network requests who need a quick, zero-configuration way to debug API calls during development, especially those using URLSession, Alamofire, or AFNetworking.
Developers choose Wormholy because it requires zero code integration—just install the library and shake your device to debug. Unlike manual logging or proxy tools, it automatically captures all traffic with SSL support and offers advanced filtering and export features.
Overview
iOS network debugging, like a wizard 🧙♂️
Use Cases
Best For
- Debugging network requests in iOS apps without adding logging code
- Inspecting API responses and headers during development
- Testing HTTPS endpoints without certificate issues
- Sharing network request examples as cURL commands
- Exporting API collections to Postman for documentation
- Filtering and analyzing network traffic by status code or host
Not Ideal For
- Apps that rely on background URL sessions for network operations
- Projects requiring network debugging or monitoring in production environments
- Teams needing programmatic debugging control without device-dependent gestures
- Applications with strict memory constraints where logging network traffic could impact performance
Pros & Cons
Pros
Simply install via CocoaPods or SPM with debug configuration—no imports or code changes needed, as it automatically hooks into URLSession.
Access the debugging interface by shaking the device or simulator, providing immediate insight without additional setup steps.
Records all requests, responses, headers, and bodies from URLSession and libraries like Alamofire, with built-in SSL support for HTTPS.
Filter by status code or blacklist hosts, and export requests as cURL commands or Postman collections for easy sharing and documentation.
Cons
Cannot inject into background URLSessionConfigurations due to Apple's limitations, making it useless for apps relying on background network tasks.
Requires iOS 16.0+, forcing developers on older iOS versions to use an outdated fork (version 1.7.x) with potential compatibility issues.
Recording all network traffic can consume memory; while configurable with a limit, developers must manually manage this to avoid performance degradation in debug builds.
Frequently Asked Questions
Related Projects
AlamofireElegant HTTP Networking in Swift
ShadowsocksX-NGNext Generation of ShadowsocksX
DoraemonKit一款面向泛前端产品研发全生命周期的效率平台。
MoyaNetwork abstraction layer written in Swift.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.