From c9feb8c05ad24c529cef9ba6cd497d96bdf221a0 Mon Sep 17 00:00:00 2001 From: ruihan Date: Mon, 9 Nov 2026 10:13:51 +0800 Subject: [PATCH] rename project to runaway --- .circleci/config.yml | 4 +- .github/ISSUE_TEMPLATE/bug_report.md | 4 +- .github/ISSUE_TEMPLATE/feature_request.md | 2 +- .github/workflows/ci.yml | 4 +- .github/workflows/release.yml | 16 +- .gitignore | 2 +- CHANGELOG.md | 10 +- CONTRIBUTING.md | 8 +- Dockerfile | 12 +- Makefile | 2 +- QUICKSTART.md | 26 +- README.md | 124 +++---- README.pt-BR.md | 30 +- ROADMAP.md | 10 +- SECURITY.md | 6 +- default.nix | 10 +- docs/_config.yml | 4 +- docs/_layouts/default.html | 6 +- docs/commands.md | 96 +++--- docs/demo.md | 14 +- docs/demo.svg | 14 +- docs/faq.md | 30 +- docs/guide.md | 22 +- docs/icon.svg | 2 +- docs/index.md | 98 +++--- docs/install.md | 34 +- docs/logo.svg | 4 +- docs/pt/commands.md | 96 +++--- docs/pt/faq.md | 28 +- docs/pt/guide.md | 22 +- docs/pt/index.md | 86 ++--- docs/pt/install.md | 34 +- docs/pt/scenarios.md | 42 +-- docs/pt/security.md | 6 +- docs/pt/troubleshooting.md | 82 ++--- docs/scenarios.md | 42 +-- docs/security.md | 6 +- docs/social-preview.svg | 6 +- docs/troubleshooting.md | 82 ++--- examples/auto-bypass-usb.sh | 12 +- examples/build-standalone.sh | 6 +- examples/prepare-ssd.sh | 8 +- examples/quickstart.sh | 24 +- examples/record-demo.sh | 18 +- lib/backup.sh | 4 +- lib/check.sh | 26 +- lib/config.sh | 16 +- lib/demo.sh | 4 +- lib/discord.sh | 8 +- lib/doctor.sh | 10 +- lib/firewall.sh | 24 +- lib/heal.sh | 20 +- lib/history.sh | 10 +- lib/init.sh | 18 +- lib/ma_detect.sh | 4 +- lib/monitor.sh | 38 +-- lib/predict.sh | 6 +- lib/remediate.sh | 2 +- lib/report.sh | 32 +- lib/selfupdate.sh | 16 +- lib/suggest.sh | 12 +- lib/suppress.sh | 12 +- lib/telemetry.sh | 6 +- lib/uninstall.sh | 28 +- lib/vpn.sh | 20 +- lib/whitelist.sh | 16 +- unleash => runaway | 40 +-- ...ash-standalone.sh => runaway-standalone.sh | 320 +++++++++--------- scripts/check-shell.py | 8 +- scripts/sign-release.sh | 6 +- tests/helpers/platform.py | 2 +- tests/setup_suite.bash | 6 +- tests/test_admin.bats | 4 +- tests/test_admin_home.bats | 8 +- tests/test_argument_safety.bats | 20 +- tests/test_backup.bats | 2 +- tests/test_colors.bats | 2 +- tests/test_config.bats | 2 +- tests/test_doctor.bats | 8 +- tests/test_dualboot.bats | 4 +- tests/test_dualboot_logging.bats | 4 +- tests/test_firewall.bats | 18 +- tests/test_history.bats | 4 +- tests/test_lint.bats | 4 +- tests/test_monitor.bats | 14 +- tests/test_network_states.bats | 8 +- tests/test_persistence.bats | 10 +- tests/test_recovery_download.bats | 8 +- tests/test_recovery_preview.bats | 6 +- tests/test_rosetta.bats | 20 +- tests/test_status.bats | 4 +- tests/test_suppression_entrypoint.bats | 4 +- tests/test_volume_output.bats | 2 +- tests/test_vpn.bats | 2 +- tests/test_whitelist.bats | 2 +- 95 files changed, 1034 insertions(+), 1034 deletions(-) rename unleash => runaway (94%) rename unleash-standalone.sh => runaway-standalone.sh (91%) diff --git a/.circleci/config.yml b/.circleci/config.yml index 6b6eedb..94b308d 100644 --- a/.circleci/config.yml +++ b/.circleci/config.yml @@ -10,7 +10,7 @@ jobs: name: ShellCheck command: | apk add bash - for f in unleash lib/*.sh examples/*.sh; do + for f in runaway lib/*.sh examples/*.sh; do [ -f "$f" ] || continue echo "Checking: $f" shellcheck -S warning "$f" || exit 1 @@ -25,7 +25,7 @@ jobs: name: Bash Syntax Check command: | apk add bash - for f in unleash lib/*.sh examples/*.sh; do + for f in runaway lib/*.sh examples/*.sh; do [ -f "$f" ] || continue echo "Checking: $f" bash -n "$f" || exit 1 diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md index e53a88d..28858f9 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -11,7 +11,7 @@ assignees: '' A clear description of what is not working. **To reproduce** -1. Run `./unleash ` from Recovery / booted system +1. Run `./runaway ` from Recovery / booted system 2. See error: ... **Expected behavior** @@ -24,7 +24,7 @@ What should have happened instead. - FileVault: (Enabled / Disabled) **Screenshots or logs** -If applicable, add output from `unleash status` or terminal logs. +If applicable, add output from `runaway status` or terminal logs. **Additional context** Anything else relevant. diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md index c1cf74e..84b7024 100644 --- a/.github/ISSUE_TEMPLATE/feature_request.md +++ b/.github/ISSUE_TEMPLATE/feature_request.md @@ -1,6 +1,6 @@ --- name: Feature request -about: Suggest an idea for unleash +about: Suggest an idea for runaway title: '' labels: enhancement assignees: '' diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 5ed70dd..bb2ca5d 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -16,7 +16,7 @@ jobs: run: sudo apt-get update -qq && sudo apt-get install -y -qq shellcheck - name: Run ShellCheck run: | - for f in unleash lib/*.sh examples/*.sh; do + for f in runaway lib/*.sh examples/*.sh; do [ -f "$f" ] || continue echo "Checking: $f" shellcheck -S warning "$f" || exit 1 @@ -29,7 +29,7 @@ jobs: - uses: actions/checkout@v7 - name: Check syntax run: | - for f in unleash lib/*.sh examples/*.sh; do + for f in runaway lib/*.sh examples/*.sh; do [ -f "$f" ] || continue echo "Checking: $f" bash -n "$f" || exit 1 diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 2646680..38a0981 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -6,20 +6,20 @@ on: jobs: update-homebrew: - name: Update homebrew-unleash formula + name: Update homebrew-runaway formula runs-on: ubuntu-latest steps: - uses: actions/checkout@v7 with: - repository: mateussiqueira/homebrew-unleash + repository: mateussiqueira/homebrew-runaway token: ${{ secrets.GH_PAT || github.token }} - name: Download release artifact and compute SHA id: sha run: | TAG="${{ github.event.release.tag_name }}" - curl -sL "https://github.com/mateussiqueira/unleash/releases/download/${TAG}/unleash-standalone.sh" -o /tmp/unleash-standalone.sh - SHA=$(shasum -a 256 /tmp/unleash-standalone.sh | cut -d' ' -f1) + curl -sL "https://github.com/mateussiqueira/runaway/releases/download/${TAG}/runaway-standalone.sh" -o /tmp/runaway-standalone.sh + SHA=$(shasum -a 256 /tmp/runaway-standalone.sh | cut -d' ' -f1) echo "sha=${SHA}" >> $GITHUB_OUTPUT echo "tag=${TAG}" >> $GITHUB_OUTPUT @@ -30,14 +30,14 @@ jobs: SHA="${{ steps.sha.outputs.sha }}" TAG="${{ steps.sha.outputs.tag }}" - sed -i "s|url \".*\"|url \"https://raw.githubusercontent.com/mateussiqueira/unleash/${TAG}/unleash-standalone.sh\"|" Formula/unleash.rb - sed -i "s|version \".*\"|version \"${VERSION}\"|" Formula/unleash.rb - sed -i "s|sha256 \".*\"|sha256 \"${SHA}\"|" Formula/unleash.rb + sed -i "s|url \".*\"|url \"https://raw.githubusercontent.com/mateussiqueira/runaway/${TAG}/runaway-standalone.sh\"|" Formula/runaway.rb + sed -i "s|version \".*\"|version \"${VERSION}\"|" Formula/runaway.rb + sed -i "s|sha256 \".*\"|sha256 \"${SHA}\"|" Formula/runaway.rb - name: Commit and push run: | git config user.name "github-actions[bot]" git config user.email "41898282+github-actions[bot]@users.noreply.github.com" - git add Formula/unleash.rb + git add Formula/runaway.rb git diff --cached --quiet || git commit -m "chore: update formula to ${{ github.event.release.tag_name }}" git push diff --git a/.gitignore b/.gitignore index c57dd15..3585c90 100644 --- a/.gitignore +++ b/.gitignore @@ -1,4 +1,4 @@ -.unleash-backup/ +.runaway-backup/ *.swp *.swo .DS_Store diff --git a/CHANGELOG.md b/CHANGELOG.md index f72ad3e..4f3b521 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -25,7 +25,7 @@ ## [1.6.1] — 2026-06-20 ### Added -- Per-command `--help` / `-h` flag (`unleash bypass --help`, etc.) +- Per-command `--help` / `-h` flag (`runaway bypass --help`, etc.) - CI rewritten to use zero-cost actions only (no Docker-based actions) - LICENSE added to standalone binary header @@ -37,8 +37,8 @@ ## [1.6.0] — 2026-06-20 ### Added -- **Homebrew tap**: `brew install mateussiqueira/unleash/unleash` -- **GitHub Pages**: full command reference at https://mateussiqueira.github.io/unleash/ +- **Homebrew tap**: `brew install mateussiqueira/runaway/runaway` +- **GitHub Pages**: full command reference at https://mateussiqueira.github.io/runaway/ - **README.pt-BR.md**: Brazilian Portuguese translation - **Bats tests**: doctor, whitelist, config, check, history, uninstall modules - **docs/index.md**: landing page for GitHub Pages @@ -69,7 +69,7 @@ ## [1.3.0] — 2026-06-20 ### Added -- **config**: Persistent settings in ~/.unleash.conf +- **config**: Persistent settings in ~/.runaway.conf - **test** command / `--dry-run` global flag - **history / history-clear**: Event log viewer - Structured logging (levels, timestamps, color, file output) @@ -102,7 +102,7 @@ ## [1.0.0] — 2026-06-20 ### Added -- Initial release of unleash — Unified MDM Bypass for macOS +- Initial release of runaway — Unified MDM Bypass for macOS - **bypass**: Full MDM bypass with admin user creation (Recovery mode) - **suppress**: Suppress MDM enrollment without creating a user - **heal**: Auto-heal — check and re-apply suppression after macOS updates diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index fc124cd..718e3a4 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,6 +1,6 @@ -# Contributing to unleash +# Contributing to runaway -Thank you for considering contributing to unleash! This document outlines the guidelines for contributions. +Thank you for considering contributing to runaway! This document outlines the guidelines for contributions. ## Code of Conduct @@ -20,8 +20,8 @@ This project follows a [Code of Conduct](CODE_OF_CONDUCT.md). By participating, 2. Create a feature branch from `main` 3. Follow the existing code style (ShellCheck compliant) 4. Test your changes: - - Syntax check: `bash -n lib/*.sh unleash` - - ShellCheck: `shellcheck lib/*.sh unleash` (install via `brew install shellcheck`) + - Syntax check: `bash -n lib/*.sh runaway` + - ShellCheck: `shellcheck lib/*.sh runaway` (install via `brew install shellcheck`) 5. Update documentation (README.md) if adding features 6. Open a PR against `main` diff --git a/Dockerfile b/Dockerfile index d4d1e69..ba36e39 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,14 +1,14 @@ FROM alpine:latest AS builder RUN apk add bash curl WORKDIR /build -COPY unleash /build/ +COPY runaway /build/ COPY lib/ /build/lib/ -RUN bash -n unleash lib/*.sh +RUN bash -n runaway lib/*.sh FROM alpine:latest RUN apk add --no-cache bash curl -COPY --from=builder /build/ /opt/unleash/ -RUN ln -s /opt/unleash/unleash /usr/local/bin/unleash -WORKDIR /opt/unleash -ENTRYPOINT ["/opt/unleash/unleash"] +COPY --from=builder /build/ /opt/runaway/ +RUN ln -s /opt/runaway/runaway /usr/local/bin/runaway +WORKDIR /opt/runaway +ENTRYPOINT ["/opt/runaway/runaway"] CMD ["--help"] diff --git a/Makefile b/Makefile index 43ae970..f2643c4 100644 --- a/Makefile +++ b/Makefile @@ -10,7 +10,7 @@ build: ./examples/build-standalone.sh clean: - rm -f unleash-standalone.sh + rm -f runaway-standalone.sh ci: lint test @echo "=== Markdown ===" diff --git a/QUICKSTART.md b/QUICKSTART.md index 811ecd5..0fcc2ad 100644 --- a/QUICKSTART.md +++ b/QUICKSTART.md @@ -1,28 +1,28 @@ -# unleash — Quick Reference +# runaway — Quick Reference Keep this on your SSD alongside the script. ## First time 1. Boot to Recovery (Apple Silicon: hold Power, Intel: Cmd+R) -2. Open Terminal → `chmod +x "/Volumes/YourSSD/unleash/unleash"` -3. Run → `"/Volumes/YourSSD/unleash/unleash"` +2. Open Terminal → `chmod +x "/Volumes/YourSSD/runaway/runaway"` +3. Run → `"/Volumes/YourSSD/runaway/runaway"` 4. Pick "Full bypass" from the menu ## Common scenarios | Você quer... | Comando | |---|---| -| Bypass completo (cria usuário admin) | `./unleash bypass` | -| Só silenciar o MDM (sem criar usuário) | `./unleash suppress` | -| Consertar depois de atualizar macOS | `sudo ./unleash heal` | -| Nunca mais pensar nisso | `sudo ./unleash persist` + `sudo ./unleash whitelist` | -| Saber se vai travar após formatar | `sudo ./unleash check` | -| Vigiar MDM em tempo real | `sudo ./unleash monitor` | -| Instalar monitor para sempre | `sudo ./unleash monitor-install` | -| Limpeza pós-bypass (já logado) | `sudo ./unleash harden` | -| Varredura completa | `sudo ./unleash audit` | -| Voltar ao normal | `./unleash restore` | +| Bypass completo (cria usuário admin) | `./runaway bypass` | +| Só silenciar o MDM (sem criar usuário) | `./runaway suppress` | +| Consertar depois de atualizar macOS | `sudo ./runaway heal` | +| Nunca mais pensar nisso | `sudo ./runaway persist` + `sudo ./runaway whitelist` | +| Saber se vai travar após formatar | `sudo ./runaway check` | +| Vigiar MDM em tempo real | `sudo ./runaway monitor` | +| Instalar monitor para sempre | `sudo ./runaway monitor-install` | +| Limpeza pós-bypass (já logado) | `sudo ./runaway harden` | +| Varredura completa | `sudo ./runaway audit` | +| Voltar ao normal | `./runaway restore` | ## Aliases diff --git a/README.md b/README.md index cd349b6..5c9e597 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,8 @@

- unleash logo + runaway logo

-# unleash +# runaway Single-script MDM bypass for macOS. Works from Recovery mode on Apple Silicon and Intel. @@ -10,7 +10,7 @@ I started this because the original bypass-mdm project had five different script ## Quick start -1. Copy the `unleash` folder to an external SSD (FAT32, APFS, or exFAT) +1. Copy the `runaway` folder to an external SSD (FAT32, APFS, or exFAT) 2. Boot to Recovery: - **Apple Silicon**: hold the power button until you see "Loading Startup Options", then click Options → Continue - **Intel**: Cmd+R at the startup chime @@ -18,14 +18,14 @@ I started this because the original bypass-mdm project had five different script 4. Run: ```bash -chmod +x "/Volumes/YourSSD/unleash/unleash" -"/Volumes/YourSSD/unleash/unleash" +chmod +x "/Volumes/YourSSD/runaway/runaway" +"/Volumes/YourSSD/runaway/runaway" ``` Pick "Full bypass" from the menu. Or if you know what you want: ```bash -"/Volumes/YourSSD/unleash/unleash" bypass +"/Volumes/YourSSD/runaway/runaway" bypass ``` No internet needed. No SIP to disable. No typing long URLs. @@ -33,8 +33,8 @@ No internet needed. No SIP to disable. No typing long URLs. If you do have internet in Recovery: ```bash -curl -L https://raw.githubusercontent.com/mateussiqueira/unleash/main/unleash-standalone.sh -o /tmp/unleash -chmod +x /tmp/unleash && /tmp/unleash bypass +curl -L https://raw.githubusercontent.com/mateussiqueira/runaway/main/runaway-standalone.sh -o /tmp/runaway +chmod +x /tmp/runaway && /tmp/runaway bypass ``` --- @@ -44,7 +44,7 @@ chmod +x /tmp/unleash && /tmp/unleash bypass ### bypass — Full MDM bypass (Recovery only) ```bash -./unleash bypass +./runaway bypass ``` Creates a temporary admin account and suppresses MDM. What it does: @@ -61,7 +61,7 @@ Creates a temporary admin account and suppresses MDM. What it does: ### suppress — Silence enrollment, no user ```bash -./unleash suppress +./runaway suppress ``` Same as bypass minus the user creation. Useful after a clean bypass breaks from a macOS update. @@ -69,7 +69,7 @@ Same as bypass minus the user creation. Useful after a clean bypass breaks from ### admin — Create admin user only (Recovery only) ```bash -./unleash admin +./runaway admin ``` Creates a hidden local administrator account on the system without performing an MDM bypass or suppression. What it does: @@ -84,8 +84,8 @@ Creates a hidden local administrator account on the system without performing an ### heal — Check and re-apply ```bash -sudo ./unleash heal # from booted system -./unleash heal # from Recovery +sudo ./runaway heal # from booted system +./runaway heal # from Recovery ``` Checks if suppression is still intact. If any piece (DEP markers, hosts block, daemon disable) has been reset, it re-applies it. Safe to run repeatedly. @@ -93,17 +93,17 @@ Checks if suppression is still intact. If any piece (DEP markers, hosts block, d ### persist — Boot-time auto-heal ```bash -sudo ./unleash persist +sudo ./runaway persist ``` -Installs a LaunchDaemon at `/Library/LaunchDaemons/com.unleash.heal.plist` that runs `unleash heal` on every boot and every 24 hours after that. Logs go to `/var/log/unleash-heal.log`. +Installs a LaunchDaemon at `/Library/LaunchDaemons/com.runaway.heal.plist` that runs `runaway heal` on every boot and every 24 hours after that. Logs go to `/var/log/runaway-heal.log`. Use this before a macOS upgrade. When the update finishes and reboots, heal runs automatically and re-applies anything the update reset. ### unpersist — Remove auto-heal ```bash -sudo ./unleash unpersist +sudo ./runaway unpersist ``` Removes the LaunchDaemon and unloads it. @@ -111,7 +111,7 @@ Removes the LaunchDaemon and unloads it. ### firewall — Kernel-level MDM block ```bash -sudo ./unleash firewall +sudo ./runaway firewall ``` Creates pf firewall rules that drop traffic to Apple's MDM IP ranges (17.0.0.0/8 and 17.128.0.0/10). pf works below DNS — DNS-over-HTTPS cannot bypass it. @@ -121,15 +121,15 @@ Creates pf firewall rules that drop traffic to Apple's MDM IP ranges (17.0.0.0/8 ### firewall-off — Remove firewall ```bash -sudo ./unleash firewall-off +sudo ./runaway firewall-off ``` -Flushes the Unleash pf anchor and restores pf.conf. +Flushes the Runaway pf anchor and restores pf.conf. ### whitelist — Block only MDM, keep iCloud ```bash -sudo ./unleash whitelist +sudo ./runaway whitelist ``` Alternative to `firewall` that resolves only the essential MDM domains (mdmenrollment.apple.com, deviceenrollment.apple.com, iprofiles.apple.com) to IPs and blocks those, leaving everything else untouched. iCloud, App Store, and updates should work normally. @@ -137,7 +137,7 @@ Alternative to `firewall` that resolves only the essential MDM domains (mdmenrol ### harden — Live cleanup from booted system ```bash -sudo ./unleash harden +sudo ./runaway harden ``` Runs from the logged-in desktop after bypass. Does: @@ -153,7 +153,7 @@ Runs from the logged-in desktop after bypass. Does: ### audit — Deep system scan ```bash -sudo ./unleash audit +sudo ./runaway audit ``` Comprehensive scan that checks: installed profiles, enrollment state, keychain certificates, user LaunchAgents, system LaunchDaemons, running processes, MDM agent binaries, pf firewall status. Ends with a risk score (LOW / MEDIUM / HIGH / CRITICAL). @@ -161,7 +161,7 @@ Comprehensive scan that checks: installed profiles, enrollment state, keychain c ### status — MDM health check (Recovery only) ```bash -./unleash status +./runaway status ``` Shows DEP markers, hosts block, daemon overrides, profile enrollment, and backup status. Only works from Recovery because that's where the Data volume is cleanly accessible. @@ -169,7 +169,7 @@ Shows DEP markers, hosts block, daemon overrides, profile enrollment, and backup ### check — Pre-format / pre-upgrade assessment ```bash -sudo ./unleash check +sudo ./runaway check ``` Answers: **"If I wipe this Mac, will it lock?"** Checks DEP records, profiles, enrollment state, firewall, and persistence. Also does an upgrade safety check — tells you if `persist` and `firewall` are installed before you upgrade macOS. @@ -182,31 +182,31 @@ Returns one of two verdicts: ### monitor — Background MDM watcher ```bash -sudo ./unleash monitor +sudo ./runaway monitor ``` Starts a daemon that checks MDM state every 5 minutes. If it detects MDM trying to re-enroll (DEP record appears, hosts block missing, enrollment becomes active), it auto-heals and sends a macOS notification. ```bash -sudo ./unleash monitor-stop # stop it -sudo ./unleash monitor-status # check if it's running +sudo ./runaway monitor-stop # stop it +sudo ./runaway monitor-status # check if it's running ``` -Logs everything to `/var/log/unleash-monitor.log`. The daemon does not survive a reboot on its own — combine with `persist` for persistence. +Logs everything to `/var/log/runaway-monitor.log`. The daemon does not survive a reboot on its own — combine with `persist` for persistence. ### backup / restore — State save ```bash -./unleash backup -./unleash restore +./runaway backup +./runaway restore ``` -Backup saves hosts, config profiles, and launchd override to `.unleash-backup/`. Restore reverts them. +Backup saves hosts, config profiles, and launchd override to `.runaway-backup/`. Restore reverts them. ### dualboot — External volume target ```bash -sudo ./unleash dualboot +sudo ./runaway dualboot ``` Same as bypass but lets you pick which volume to target (for external macOS installs or dual-boot setups). Prompts for system and data volume names. @@ -214,8 +214,8 @@ Same as bypass but lets you pick which volume to target (for external macOS inst ### version / help ```bash -./unleash version -./unleash help +./runaway version +./runaway help ``` --- @@ -249,14 +249,14 @@ Global options that can go before any command: Example: ```bash -sudo ./unleash --verbose --log-file /tmp/unleash.log heal +sudo ./runaway --verbose --log-file /tmp/runaway.log heal ``` --- ## How it works -MDM enrollment on macOS sits on four layers. Unleash addresses each one. +MDM enrollment on macOS sits on four layers. Runaway addresses each one. ### Layer 1: DEP activation record @@ -269,13 +269,13 @@ When an organization assigns a device in Apple Business Manager, macOS creates m .cloudConfigTimerCheck ← "check again later" ``` -Unleash removes these and creates decoy files (`.cloudConfigRecordNotFound`, `.cloudConfigProfileInstalled`) that signal "no enrollment needed." +Runaway removes these and creates decoy files (`.cloudConfigRecordNotFound`, `.cloudConfigProfileInstalled`) that signal "no enrollment needed." ### Layer 2: Network blocking The enrollment client contacts Apple servers to download the MDM profile. Without network access, it cannot complete enrollment. -Unleash blocks via `/etc/hosts`: +Runaway blocks via `/etc/hosts`: - `iprofiles.apple.com` — profile delivery - `deviceenrollment.apple.com` — DEP service @@ -308,7 +308,7 @@ macOS registers enrollment daemons that run at boot: | `com.apple.mdmclient.daemon.runatboot` | MDM client | | `com.apple.activationd` | Device activation | -Unleash disables them via the launchd override at `/private/var/db/com.apple.xpc.launchd/disabled.plist`. +Runaway disables them via the launchd override at `/private/var/db/com.apple.xpc.launchd/disabled.plist`. ### Layer 4: User-level cleanup @@ -321,11 +321,11 @@ Home directories carry MDM artifacts that trigger re-enrollment after login: ~/Library/LaunchAgents/com.apple.mdm.* ``` -Unleash removes these from every home directory on the Data volume. This is the step most scripts miss — and the reason MDM comes back after Migration Assistant. +Runaway removes these from every home directory on the Data volume. This is the step most scripts miss — and the reason MDM comes back after Migration Assistant. ### Layer 5: pf firewall (optional) -The hosts file can be bypassed by DNS-over-HTTPS or cached DNS. pf (packet filter) operates at the kernel level and is immune to both. Unleash installs pf rules that either: +The hosts file can be bypassed by DNS-over-HTTPS or cached DNS. pf (packet filter) operates at the kernel level and is immune to both. Runaway installs pf rules that either: - **firewall**: blocks Apple's entire IP range (17.0.0.0/8 + 17.128.0.0/10) — aggressive but 100% effective - **whitelist**: resolves only MDM domains to IPs and blocks those specifically — keeps iCloud working @@ -365,11 +365,11 @@ The old bypass scripts only clean system-level artifacts (DEP markers, hosts, la ### Solution -**From Recovery**: run `unleash bypass` (or `suppress`). This cleans both system-level and user-level artifacts. +**From Recovery**: run `runaway bypass` (or `suppress`). This cleans both system-level and user-level artifacts. -**If MDM still comes back**: boot normally, run `sudo ./unleash harden` immediately after login. This kills active MDM processes and removes profiles before they can re-establish. +**If MDM still comes back**: boot normally, run `sudo ./runaway harden` immediately after login. This kills active MDM processes and removes profiles before they can re-establish. -**For prevention**: run `sudo ./unleash persist` and `sudo ./unleash whitelist` before Migration Assistant. The LaunchDaemon + pf rules survive the migration and catch anything that slips through. +**For prevention**: run `sudo ./runaway persist` and `sudo ./runaway whitelist` before Migration Assistant. The LaunchDaemon + pf rules survive the migration and catch anything that slips through. ## Hard lock: DFU / IPSW restore @@ -386,7 +386,7 @@ If MDM is unbreakable — even from Recovery — the device may need a full firm 4. Right-click → Advanced → Restore (pick the IPSW file) 5. Wait 10-30 minutes for restore to finish 6. Mac reboots to Setup Assistant — **do not connect to Wi-Fi** -7. Immediately boot to Recovery (hold power) and run `unleash bypass` +7. Immediately boot to Recovery (hold power) and run `runaway bypass` **This erases all data.** IPSW files are available at [ipsw.me](https://ipsw.me). @@ -398,7 +398,7 @@ All commands now log with timestamps and levels: [INF] Data volume: /Volumes/Macintosh HD - Data [ OK] Admin 'apple' created (UID 501) [WRN] DEP activation record present -[ERR] Firewall needs sudo: sudo ./unleash firewall +[ERR] Firewall needs sudo: sudo ./runaway firewall [STP] Locating Data volume by APFS role... [DBG] Checking pfctl availability ``` @@ -408,8 +408,8 @@ Use `--verbose` to see debug messages and `--log-file ` to write everythin ## Files ``` -unleash/ -├── unleash # Main script (entry point) +runaway/ +├── runaway # Main script (entry point) ├── lib/ │ ├── colors.sh # Logging, colors, prompts │ ├── detect.sh # Recovery detection, volume mounting @@ -432,7 +432,7 @@ unleash/ └── LICENSE (MIT) ``` -The standalone variant (`unleash-standalone.sh`) bundles everything into one file. Build it with `bash examples/build-standalone.sh`. +The standalone variant (`runaway-standalone.sh`) bundles everything into one file. Build it with `bash examples/build-standalone.sh`. ## Limitations @@ -444,7 +444,7 @@ The standalone variant (`unleash-standalone.sh`) bundles everything into one fil ## Safety -Unleash is designed to be safe: +Runaway is designed to be safe: - **No SSV writes** — all changes target the Data volume - **Reversible** — `backup` saves state, `restore` reverts @@ -455,26 +455,26 @@ Unleash is designed to be safe: ## Troubleshooting ### MDM comes back after reboot -Run `unleash suppress` from Recovery. If it still returns, you have Migration Assistant artifacts. Run `unleash harden` from the booted system. +Run `runaway suppress` from Recovery. If it still returns, you have Migration Assistant artifacts. Run `runaway harden` from the booted system. ### profiles shows enrollment -Cosmetic. The SSV stores profile state but the enrollment daemons are disabled. Run `unleash status` to check the actual state on the Data volume. +Cosmetic. The SSV stores profile state but the enrollment daemons are disabled. Run `runaway status` to check the actual state on the Data volume. ### FileVault unlock fails You need a user password or the FileVault recovery key. If neither is available, the Data volume cannot be mounted from Recovery. ### "Not a macOS Data volume" -Unleash checks for `/private/var/db/dslocal/nodes/Default` on the mounted volume. If it's missing, you mounted the wrong disk. Run `diskutil list` to find the correct one. +Runaway checks for `/private/var/db/dslocal/nodes/Default` on the mounted volume. If it's missing, you mounted the wrong disk. Run `diskutil list` to find the correct one. ### macOS 27 and later -[#22](https://github.com/mateussiqueira/unleash/issues/22) contains two positive +[#22](https://github.com/mateussiqueira/runaway/issues/22) contains two positive community reports for macOS 27.2: -- The [original reporter](https://github.com/mateussiqueira/unleash/issues/22#issuecomment-6522921874) - reports Unleash 2.0.0 working on an M1 Pro after upgrading an existing Sequoia +- The [original reporter](https://github.com/mateussiqueira/runaway/issues/22#issuecomment-6522921874) + reports Runaway 2.0.0 working on an M1 Pro after upgrading an existing Sequoia setup. This was not a fresh installation. -- [Another user](https://github.com/mateussiqueira/unleash/issues/22#issuecomment-6520816615) +- [Another user](https://github.com/mateussiqueira/runaway/issues/22#issuecomment-6520816615) reports basic commands working on a MacBook Neo (Apple A18 Pro). These reports answer the original question but do not establish support for every @@ -483,11 +483,11 @@ matrix. Shell regression tests are separate from hardware validation. ### Wi-Fi on an external startup disk -[#24](https://github.com/mateussiqueira/unleash/issues/24) remains under +[#24](https://github.com/mateussiqueira/runaway/issues/24) remains under investigation. From the affected external installation, run: ```bash -./unleash doctor --network +./runaway doctor --network ``` This read-only command reports the macOS build, Wi-Fi interface, power, link, and @@ -501,7 +501,7 @@ A failed query is reported separately from a successful query with no Wi-Fi port Include the script commit, Mac model, exact OS build, SSD/cable/hub connection, and whether Wi-Fi worked on that same external installation before running -Unleash, if known. Working Wi-Fi on the internal installation alone does not +Runaway, if known. Working Wi-Fi on the internal installation alone does not isolate what changed on the external one. The `dualboot` code does not directly rewrite Wi-Fi preferences or toggle the @@ -515,7 +515,7 @@ disk cables or hubs, shut down before changing their connections; do not unplug the active startup disk. ### Monitor won't start -Check if it's already running (`monitor-status`). Check permissions — it needs root. Check logs at `/var/log/unleash-monitor.log`. +Check if it's already running (`monitor-status`). Check permissions — it needs root. Check logs at `/var/log/runaway-monitor.log`. ## FAQ @@ -538,7 +538,7 @@ The serial stays in ABM. If the device connects to the internet with enrollment Use `whitelist` instead of `firewall` or `suppress`. It blocks only MDM endpoints. **Why does MDM come back after Migration Assistant?** -MA copies user-level caches, preferences, and launch agents. Unleash handles this — run `bypass` or `suppress` from Recovery after migrating. +MA copies user-level caches, preferences, and launch agents. Runaway handles this — run `bypass` or `suppress` from Recovery after migrating. ## Contributing diff --git a/README.pt-BR.md b/README.pt-BR.md index 208bdda..b3b3e35 100644 --- a/README.pt-BR.md +++ b/README.pt-BR.md @@ -1,4 +1,4 @@ -# unleash +# runaway Ferramenta única para bypass/supressão de MDM no macOS. Funciona do Modo de Recuperação. Apple Silicon e Intel. @@ -8,30 +8,30 @@ Ferramenta única para bypass/supressão de MDM no macOS. Funciona do Modo de Re ```bash # Homebrew (mais fácil) -brew install mateussiqueira/unleash/unleash +brew install mateussiqueira/runaway/runaway # Download direto -curl -L https://raw.githubusercontent.com/mateussiqueira/unleash/main/unleash-standalone.sh -o unleash -chmod +x unleash && sudo ./unleash +curl -L https://raw.githubusercontent.com/mateussiqueira/runaway/main/runaway-standalone.sh -o runaway +chmod +x runaway && sudo ./runaway ``` ## Como usar -1. Copie a pasta `unleash` para um SSD externo (FAT32/APFS/exFAT) +1. Copie a pasta `runaway` para um SSD externo (FAT32/APFS/exFAT) 2. Inicialize no Modo de Recuperação: - **Apple Silicon**: segure o botão de energia → Opções → Continuar - **Intel**: Cmd+R na inicialização 3. Abra o Terminal (Utilitários) e execute: ```bash -chmod +x "/Volumes/SeuSSD/unleash/unleash" -"/Volumes/SeuSSD/unleash/unleash" +chmod +x "/Volumes/SeuSSD/runaway/runaway" +"/Volumes/SeuSSD/runaway/runaway" ``` Escolha "Full bypass" no menu. Ou use a linha de comando: ```bash -"/Volumes/SeuSSD/unleash/unleash" bypass +"/Volumes/SeuSSD/runaway/runaway" bypass ``` ## Comandos principais @@ -63,11 +63,11 @@ Escolha "Full bypass" no menu. Ou use a linha de comando: ## Por que não usar só o bypass-mdm? -O projeto original cresceu para 5 scripts (v2, v3, express, dualboot.sh, verify.sh), cada um com opções diferentes. O Unleash substitui todos em um único comando. +O projeto original cresceu para 5 scripts (v2, v3, express, dualboot.sh, verify.sh), cada um com opções diferentes. O Runaway substitui todos em um único comando. ## Como funciona -O MDM opera em 4 camadas. O Unleash ataca todas: +O MDM opera em 4 camadas. O Runaway ataca todas: 1. **Marcadores DEP** — remove arquivos `.cloudConfig*`, cria iscas 2. **Rede** — `/etc/hosts` bloqueia 13+ domínios Apple + servidor MDM da org @@ -87,19 +87,19 @@ Firewall pf (comandos `firewall`/`whitelist`) pega o que o `/etc/hosts` não con ## Migration Assistant -Se você migrar de um Intel para Apple Silicon, o MDM vai voltar após o reboot. O Migration Assistant copia artefatos de usuário que os scripts antigos não limpam. O Unleash limpa `/Users/*/Library` explicitamente. +Se você migrar de um Intel para Apple Silicon, o MDM vai voltar após o reboot. O Migration Assistant copia artefatos de usuário que os scripts antigos não limpam. O Runaway limpa `/Users/*/Library` explicitamente. -Se ainda assim voltar, execute `sudo ./unleash harden` do sistema já iniciado. +Se ainda assim voltar, execute `sudo ./runaway harden` do sistema já iniciado. ## Troubleshooting -**MDM volta após reboot** — execute `unleash suppress` da Recuperação. Se persistir, são artefatos do Migration Assistant. Execute `unleash harden` após o login. +**MDM volta após reboot** — execute `runaway suppress` da Recuperação. Se persistir, são artefatos do Migration Assistant. Execute `runaway harden` após o login. -**profiles mostra matrícula** — cosmético. O SSV armazena estado de perfil em modo somente leitura. Verifique os marcadores DEP com `unleash status`. +**profiles mostra matrícula** — cosmético. O SSV armazena estado de perfil em modo somente leitura. Verifique os marcadores DEP com `runaway status`. **FileVault não desbloqueia** — você precisa da senha de um usuário ou da chave de recuperação. -**Update do macOS** — execute `unleash heal`. Se usou `persist` antes do update, ele faz isso automaticamente. +**Update do macOS** — execute `runaway heal`. Se usou `persist` antes do update, ele faz isso automaticamente. ## Limitações diff --git a/ROADMAP.md b/ROADMAP.md index 1573c2e..c0c8a9a 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -5,7 +5,7 @@ ### July — v1.7.0 "Solidify" - [ ] **Resolve GitHub Actions billing** — re-enable CI/CD - [ ] **Fix CI pipeline** — all checks passing on every PR -- [ ] **Homebrew audit** — `brew audit --strict` passes on `mateussiqueira/unleash/unleash` +- [ ] **Homebrew audit** — `brew audit --strict` passes on `mateussiqueira/runaway/runaway` - [ ] **Improve bats test coverage** — mock-based tests for firewall, monitor, vpn modules - [ ] **Add `--help` flag** per command (currently only global `-h`) @@ -19,7 +19,7 @@ ### September — v2.0.0 "Foundation" - [ ] **Homebrew core** — submit PR to official Homebrew/homebrew-core - [ ] **`docs/` site with Jekyll** — proper multi-page site, not just a single markdown file -- [ ] **`unleash init` wizard** — interactive setup: asks questions, runs doctor, suggests commands +- [ ] **`runaway init` wizard** — interactive setup: asks questions, runs doctor, suggests commands - [ ] **Release signing** — GPG-signed releases + checksums file - [ ] **Self-update with GPG verification** @@ -35,7 +35,7 @@ ### November — v2.2.0 "Intelligence" - [ ] **Predictive check** — given a serial number, predict which org the Mac is enrolled in -- [ ] **Risk-based suggestions** — `unleash suggest` reads system state and recommends commands +- [ ] **Risk-based suggestions** — `runaway suggest` reads system state and recommends commands - [ ] **Remediation scripts** — per-org MDM quirks (some orgs use custom domains or certs) - [ ] **Discord bot** — monitor MDM status via Discord DM @@ -50,7 +50,7 @@ ## Stretch goals (if time/budget allows) - **Windows dual-boot MDM detection** — detect if a Windows partition carries MDM payloads -- **Linux live USB** — standalone Linux environment with unleash pre-loaded for Recovery +- **Linux live USB** — standalone Linux environment with runaway pre-loaded for Recovery - **GUI wrapper** — simple SwiftUI app that calls the CLI - **Localization** — Spanish, French, German command output - **CI/CD with `act`** — documented local CI workflow for offline development @@ -59,4 +59,4 @@ ## How to contribute -Pick any unchecked item, open an issue or discussion, and submit a PR. See [CONTRIBUTING.md](https://github.com/mateussiqueira/unleash/blob/main/CONTRIBUTING.md) for guidelines. +Pick any unchecked item, open an issue or discussion, and submit a PR. See [CONTRIBUTING.md](https://github.com/mateussiqueira/runaway/blob/main/CONTRIBUTING.md) for guidelines. diff --git a/SECURITY.md b/SECURITY.md index dbc4dce..927641b 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -13,18 +13,18 @@ This tool modifies system configuration to suppress MDM enrollment. While design To report a vulnerability: 1. **Do NOT** open a public issue -2. Open a [security advisory](https://github.com/mateussiqueira/unleash/security/advisories) privately +2. Open a [security advisory](https://github.com/mateussiqueira/runaway/security/advisories) privately 3. Or email the maintainer directly ## Safety Guarantees - **No system volume writes**: All operations target the Data volume only -- **Reversible**: `unleash backup`/`restore` saves and reverts all changes +- **Reversible**: `runaway backup`/`restore` saves and reverts all changes - **No data loss**: Never runs `profiles renew` or erase commands - **No ABM modification**: Does not touch Apple Business Manager records ## Known Limitations - Serial numbers remain in ABM after bypass -- macOS updates may reset suppression (use `unleash heal`) +- macOS updates may reset suppression (use `runaway heal`) - Profile enrollment status may still show as active (cosmetic, from SSV) diff --git a/default.nix b/default.nix index 68153b8..17719d8 100644 --- a/default.nix +++ b/default.nix @@ -1,22 +1,22 @@ { pkgs ? import {} }: pkgs.stdenv.mkDerivation rec { - pname = "unleash"; + pname = "runaway"; version = "1.6.1"; src = ./.; installPhase = '' mkdir -p $out/bin - cp unleash $out/bin/ - chmod +x $out/bin/unleash + cp runaway $out/bin/ + chmod +x $out/bin/runaway cp -r lib $out/lib/ - cp -r examples $out/share/unleash/ + cp -r examples $out/share/runaway/ ''; meta = with pkgs.lib; { description = "Single-script MDM bypass for macOS"; - homepage = "https://github.com/mateussiqueira/unleash"; + homepage = "https://github.com/mateussiqueira/runaway"; license = licenses.mit; platforms = platforms.darwin; maintainers = [ maintainers.mateussiqueira ]; diff --git a/docs/_config.yml b/docs/_config.yml index d0ea367..92a5afa 100644 --- a/docs/_config.yml +++ b/docs/_config.yml @@ -1,6 +1,6 @@ -title: unleash +title: runaway description: Single-script MDM bypass for macOS — covers all 5 layers of Apple MDM enrollment -url: "https://unleash-nine.vercel.app" +url: "https://runaway-nine.vercel.app" baseurl: "" theme: jekyll-theme-cayman markdown: kramdown diff --git a/docs/_layouts/default.html b/docs/_layouts/default.html index 1f9e13d..2f09043 100644 --- a/docs/_layouts/default.html +++ b/docs/_layouts/default.html @@ -19,7 +19,7 @@ Skip to the content.