{"id":28300512,"url":"https://github.com/stephendev0/stikdebug","last_synced_at":"2026-03-08T20:05:38.130Z","repository":{"id":284679040,"uuid":"955665884","full_name":"StephenDev0/StikDebug","owner":"StephenDev0","description":"An on-device debugger/JIT enabler for iOS versions 17.4+ (excluding iOS 18.4 beta 1), powered by idevice.","archived":false,"fork":false,"pushed_at":"2025-06-08T04:52:13.000Z","size":235853,"stargazers_count":500,"open_issues_count":2,"forks_count":51,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-06-08T05:42:40.267Z","etag":null,"topics":["idevice","ios","jit","just-in-time","stikjit","swiftui"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/StephenDev0.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-27T02:05:59.000Z","updated_at":"2025-06-08T04:52:18.000Z","dependencies_parsed_at":"2025-04-11T14:06:06.807Z","dependency_job_id":"452021d1-6f07-4deb-89a2-838e36adc2a7","html_url":"https://github.com/StephenDev0/StikDebug","commit_stats":null,"previous_names":["0-blu/stikjit","stephendev0/stikjit","stephendev0/stikdebug"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/StephenDev0/StikDebug","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StephenDev0%2FStikDebug","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StephenDev0%2FStikDebug/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StephenDev0%2FStikDebug/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StephenDev0%2FStikDebug/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/StephenDev0","download_url":"https://codeload.github.com/StephenDev0/StikDebug/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StephenDev0%2FStikDebug/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260251149,"owners_count":22980977,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["idevice","ios","jit","just-in-time","stikjit","swiftui"],"created_at":"2025-05-23T18:00:40.510Z","updated_at":"2026-03-08T20:05:38.116Z","avatar_url":"https://github.com/StephenDev0.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003e [!CAUTION]\n\u003e **WARNING:** There are known critical issues with **iOS 26.4 Developer Beta 1**. The `lockdownd` service appears to be dropping connections, which interferes with how the device connects to itself (loopback/pairing issues) and prevents JIT from functioning. **DO NOT UPDATE** if you rely on StikDebug. These issues and possible fixes are currently being investigated.\n\n\u003cdiv align=\"center\"\u003e\n   \u003cimg width=\"217\" height=\"217\" src=\"/assets/StikJIT.png\" alt=\"Logo\"\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003e\u003cb\u003eStikDebug\u003c/b\u003e\u003c/h1\u003e\n  \u003cp\u003e\u003ci\u003eAn on-device debugger/JIT enabler for iOS versions 17.4+ powered by \u003ca href=\"https://github.com/jkcoxson/idevice\"\u003eidevice\u003c/a\u003e.\u003c/i\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n\u003ch6 align=\"center\"\u003e\n  \u003ca href=\"https://discord.gg/ZnNcrRT3M8\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Discord-join%20us-7289DA?logo=discord\u0026logoColor=white\u0026style=for-the-badge\u0026labelColor=23272A\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/StephenDev0/StikDebug/blob/main/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/StephenDev0/StikDebug?label=License\u0026color=5865F2\u0026style=for-the-badge\u0026labelColor=23272A\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/StephenDev0/StikDebug/stargazers\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/stars/StephenDev0/StikDebug?label=Stars\u0026color=FEE75C\u0026style=for-the-badge\u0026labelColor=23272A\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/StephenDev0/StikDebug/releases\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/v/release/StephenDev0/StikDebug?label=Latest\u0026color=00BFFF\u0026style=for-the-badge\u0026labelColor=23272A\" /\u003e\n  \u003c/a\u003e\n  \u003cbr /\u003e\n\u003c/h6\u003e\n\n## Features\n- **JIT:** Enable Just In Time compilation for sideloaded apps that have the `get-task-allow` entitlement.\n- **App Launching:** Launch every app installed on your device.\n- **Console:** Live app and system logs.\n- **Scripts:** Manage automation scripts (mainly used for iOS 26 JIT). \n- **App Expiry:** See when apps will expire and install/remove profiles.\n- **Device Info:** View detailed device metadata.\n- **Processes:** Inspect running apps/processes and terminate them.\n- **Location Simulator:** Simulate the GPS location of your device.\n\n## Download\n\u003e [!WARNING]\n\u003e **Notice:** StikDebug is no longer available on the App Store. Please use the official download methods below.\n\n\u003cdiv align=\"center\" style=\"display: flex; justify-content: center; align-items: center; gap: 16px; flex-wrap: wrap;\"\u003e\n   \u003ca href=\"https://stikstore.app/altdirect/?url=https://stikdebug.xyz/index.json\" target=\"_blank\"\u003e\n     \u003cimg src=\"https://github.com/stikstore/altdirect/blob/main/assets/png/AltSource_Blue.png\" alt=\"Add AltSource\" width=\"200\"\u003e\n   \u003c/a\u003e\n   \u003ca href=\"https://github.com/StephenDev0/StikDebug/releases/download/3.0.1/StikDebug-3.0.1.ipa\" target=\"_blank\"\u003e\n     \u003cimg src=\"https://github.com/stikstore/altdirect/blob/main/assets/png/Download_Blue.png\" alt=\"Download .ipa\" width=\"200\"\u003e\n   \u003c/a\u003e\n\u003c/div\u003e\n\n## Compatibility\n\n| iOS Version              | Status               | Notes                                                                 |\n|--------------------------|----------------------|-----------------------------------------------------------------------|\n| 1.0 – 17.3.X             | Not supported        | Uses Different Connection Protocols                                   |\n| 17.4 – 18.x              | Fully supported      | Stable                                                                |\n| 26.0 – 26.3              | Supported            | Limited App Availability (Developers need to update their apps to work.) |\n| 26.4 Developer Beta 1    | Critical issues   | lockdownd drops connections → JIT broken; do not update                  |\n| iOS 26.4+ betas / future | Untested / partial   | Check [Discord](https://discord.gg/ZnNcrRT3M8), [releases](https://github.com/StephenDev0/StikDebug/releases), or [@StephenDev0 on X](https://x.com/stephendev0) for updates |\n\n## How to Enable JIT\n\nStikDebug enables **JIT** for sideloaded apps on iOS 17.4+ without needing a computer after the initial pairing setup.\n\n### Requirements\n- StikDebug installed (via AltSource, direct .ipa, or self-built)\n- A valid **pairing file** (.plist / .mobiledevicepairing) for your device\n- SideStore / AltStore / similar sideload tool (for app refreshing)\n- A loopback VPN such as [LocalDevVPN](https://apps.apple.com/us/app/localdevvpn/id6755608044)\n\n### Steps\n1. **Obtain a pairing file**  \n   - Detailed guide: [Pairing File Instructions](https://github.com/StephenDev0/StikDebug-Guide/blob/main/pairing_file.md) (or ask in Discord).\n\n2. **Set up VPN**  \n   - Launch LocalDevVPN and enable the VPN.\n\n4. **Enable JIT for an app**  \n   - Launch StikDebug and tapp the `Enable JIT` button.\n   - Select your sideloaded app from the list in StikDebug.  \n\n**Troubleshooting**  \n- \"Connection dropped\" or loopback errors → Check iOS version compatibility / beta warnings.  \n- Heartbeat errors → Ensure that the VPN is on and that you are connecected to Wi-Fi. It may be a pairing file issue.\n- Pairing file issues → Replace file with device unlocked \u0026 trusted.  \n- Still stuck? Join the [Discord](https://discord.gg/ZnNcrRT3M8) with logs/screenshots.\n\n\u003c!-- \n## Screenshots\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"screenshots/pairing-import.png\" width=\"320\" alt=\"Pairing file import screen\"\u003e\n  \u003cimg src=\"screenshots/app-list.png\" width=\"320\" alt=\"Sideloaded apps list\"\u003e\n  \u003cimg src=\"screenshots/jit-enabled.png\" width=\"320\" alt=\"JIT successfully enabled\"\u003e\n  \u003cimg src=\"screenshots/processes.png\" width=\"320\" alt=\"Process management tab\"\u003e\n\u003c/div\u003e\n\n(Add images to a /screenshots/ folder in the repo and uncomment when ready.)\n--\u003e\n\n## Building from Source\n\u003e [!NOTE]\n\u003e StikDebug is an open-source Xcode project written mostly in Swift. Building yourself lets you modify code, debug, or create custom versions. Requires a Mac with Xcode.\n\n### Requirements\n- macOS (latest recommended)\n- Xcode 16+ (Xcode 26+ preferred for iOS 26+ support)\n- iOS device on iOS 17.4+ (for testing)\n- Git\n- Basic Xcode/Swift knowledge\n\n### Steps\n1. **Clone the repo**\n   ```bash\n   git clone https://github.com/StephenDev0/StikDebug.git\n   cd StikDebug\n   ```\n\n2. **Open in Xcode**\n   - Launch Xcode\n   - Open `StikDebug.xcodeproj`\n\n3. **Configure signing**\n   - Select the **StikDebug** target\n   - Go to **Signing \u0026 Capabilities**\n   - Sign in with your Apple ID (free or paid developer account)\n   - Set a unique **Bundle Identifier** (e.g., `com.yourname.StikDebug`)\n\n4. **Build \u0026 install**\n   - Select your connected device\n   - Press **Cmd + R** (or Product → Run)\n   - Trust the certificate on device: Settings → General → VPN \u0026 Device Management\n\nAfter install, follow the JIT setup steps above (pairing import, etc.).\n\n## Contributing\n\nThank you for your interest in contributing to this project. Contributions of all kinds are welcome.\n\n### Reporting Bugs\nIf you discover a bug, please open an issue and include:\n- A clear and descriptive title\n- Steps to reproduce the issue\n- Expected behavior vs. actual behavior\n- Relevant logs, screenshots, or environment details (iOS version, device model, etc.)\n\n### Suggesting Features\nTo propose a new feature, open a feature request issue and provide:\n- A clear description of the feature\n- The problem it solves or the use case it addresses\n- Any relevant examples or implementation ideas\n\n### Code Contributions (Best Practices)\n- Follow normal Swift and SwiftUI style.\n- Write clear and easy to understand code.\n- Keep your changes consistent with how the project is already set up.\n- Make sure everything builds and works without errors.\n\nWe appreciate your time and effort in helping improve this project.\n\n## Code Help\n[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/stephendev0/stikdebug)\n## License\nStikDebug is licensed under **AGPL-3.0**. See [`LICENSE`](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstephendev0%2Fstikdebug","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstephendev0%2Fstikdebug","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstephendev0%2Fstikdebug/lists"}