Commit Graph
84 Commits
Author SHA1 Message Date
ruihan 5ada0ff873 fix(doctor): distinguish failed queries from missing Wi-Fi 2026-10-30 11:34:53 -03:00
ruihan 96a6d5cae2 fix(cli): avoid target access during previews (#38)
Return before volume access in suppression previews
2026-10-30 11:33:30 -03:00
ruihan 870ac48d02 fix(cli): skip volume access during suppression previews 2026-10-30 11:31:43 -03:00
ruihan 60ddbff5e2 fix(suppress): tolerate absent activation metadata (#37)
Allow absent optional activation metadata during suppression
2026-10-30 11:28:50 -03:00
ruihan 9941dd609a fix(suppress): tolerate absent optional activation metadata 2026-10-30 11:26:57 -03:00
ruihan e98f4289ae feat(admin): add a Recovery-only local account command (#13)
Add a Recovery-only local admin command
2026-10-30 11:16:00 -03:00
ruihan 42319a494c fix(admin): stop dry runs before resolving the target volume 2026-10-30 11:13:58 -03:00
ruihan e9d88120e4 Merge remote-tracking branch 'origin/main' into integrate/pr13 2026-10-30 11:13:55 -03:00
ruihan e9b326dcef fix(recovery): download the standalone entrypoint (#16)
Download the standalone script in Recovery instructions
2026-10-30 11:13:22 -03:00
ruihan 6640d27245 test(recovery): run the documented download without libraries 2026-10-30 11:12:07 -03:00
ruihan aa4f0ad754 Merge remote-tracking branch 'origin/main' into integrate/pr16 2026-10-30 11:12:04 -03:00
ruihan 4364488aca fix(profiles): keep preflight queries read-only (#36)
Keep preflight profile queries read-only and numeric
2026-10-30 11:11:39 -03:00
ruihan f185091247 test(audit): reject arithmetic diagnostics across Bash versions 2026-10-30 11:10:22 -03:00
ruihan 9f95353074 fix(profiles): keep preflight queries read-only and numeric 2026-10-30 11:10:22 -03:00
ruihan 7f0aecf073 fix(doctor): expose read-only build and Wi-Fi diagnostics (#35)
Expose read-only macOS build and Wi-Fi diagnostics
2026-10-30 11:10:04 -03:00
ruihan 8240669504 fix(doctor): expose read-only build and Wi-Fi diagnostics 2026-10-30 11:08:20 -03:00
ruihan 4d2c3d6d7d fix(dualboot): stop dry runs before target access (#34)
Return before target access in dualboot dry runs
2026-10-30 11:08:00 -03:00
ruihan f08540ca19 fix(dualboot): stop dry runs before accessing target state 2026-10-30 11:06:23 -03:00
ruihan 035d2355d5 fix(rosetta): repair generated hosts blocks (#27)
Restore Rosetta access in generated hosts blocks
2026-10-30 11:04:45 -03:00
ruihan 1bf35ab567 fix(heal): restore Rosetta access on intact installations 2026-10-30 11:03:00 -03:00
ruihan e130716813 fix(suppression): repair generated Rosetta hosts blocks 2026-10-30 11:03:00 -03:00
ruihan 1a48fca9fb Merge remote-tracking branch 'origin/main' into integrate/rosetta 2026-10-30 11:02:58 -03:00
ruihan c4f6d486a5 fix(audit): emit valid zero counts (#33)
Emit valid zero counts in profile audits
2026-10-30 11:02:36 -03:00
ruihan ee93df167c fix(audit): emit valid zero counts without nounset failures 2026-10-30 11:01:17 -03:00
ruihan 0730f51d03 fix(monitor): preserve literal daemon arguments (#32)
Preserve the monitor script path in launchd arguments
2026-10-30 11:00:54 -03:00
ruihan 26ef4ba6d6 fix(monitor): preserve literal daemon script arguments 2026-10-30 10:58:28 -03:00
ruihan d96cbae382 fix(persistence): invoke the installed script literally (#31)
Invoke the installed script path literally from launchd
2026-10-30 10:58:13 -03:00
ruihan 7a7f8f464a fix(persistence): invoke the installed script path literally 2026-10-30 10:57:04 -03:00
ruihan dbd7ad3476 fix(cli): preserve optional argument boundaries (#30)
Preserve CLI argument boundaries and optional values
2026-10-30 10:56:49 -03:00
ruihan 97cb71eb80 fix(cli): preserve optional argument boundaries 2026-10-30 10:55:34 -03:00
ruihan b48be5b7b7 fix(volumes): keep mount diagnostics out of paths (#29)
Keep disk mount output out of captured volume paths
2026-10-30 10:55:16 -03:00
ruihan 04801f080a fix(volumes): keep mount diagnostics out of captured paths 2026-10-30 10:54:06 -03:00
ruihan 0bc200e04c fix(logging): keep diagnostics out of captured values (#12)
Keep diagnostics out of captured helper output
2026-10-30 10:53:29 -03:00
ruihan 8566819c00 merge: reconcile logging regressions with local validation 2026-10-30 10:52:25 -03:00
ruihan 1d757ebab5 fix(validation): restore local shell gates (#28)
Validate all shell sources and isolate platform fixtures before accepting maintenance changes.
2026-10-30 10:51:35 -03:00
ruihan 5fb2ba6df8 test(fixtures): allow the active test temporary directory 2026-10-30 04:31:38 -03:00
ruihan 3151b0c7dd fix(validation): restore isolated local checks 2026-10-30 04:21:56 -03:00
ruihan d49c99c6ca test(suppression): assert the Rosetta block lookup status 2026-10-30 03:56:33 -03:00
ruihan c7bb2d6dc9 fix(suppression): preserve access to Rosetta configuration 2026-10-30 03:56:14 -03:00
ruihan c9f0549591 fix(admin): reject account creation outside Recovery 2026-10-30 03:53:32 -03:00
ruihan 97c181be60 test(logging): keep helper output free of diagnostics 2026-10-30 03:51:08 -03:00
ruihan 2c53c1f921 docs: update recovery curl command to use standalone script 2026-07-20 13:09:39 +00:00
ruihan 61e49f4880 docs: add admin command section to README 2026-07-20 13:02:00 +00:00
ruihan fbef9c314b feat: add standalone local administrator creation mode 2026-07-09 15:07:12 +00:00
ruihan 1cb0fb2a07 fix: redirect low-level logging functions to STDERR 2026-07-06 01:32:02 +00:00
ruihan 82188e8731 docs: add search, sidebar nav, dedicated pages, PT translations 2026-06-24 11:19:43 -03:00
ruihan ba78d1757c ci: auto-update homebrew formula on release publish
Adds a release workflow that:
- Triggers on GitHub release publish
- Downloads the release artifact
- Computes the correct SHA-256
- Updates homebrew-unleash formula with pinned tag URL and SHA
- Auto-commits and pushes
2026-06-24 09:34:52 -03:00
ruihan c59b8cfb9c chore(deps): bump actions/checkout from 4 to 7
chore(deps): bump actions/checkout from 4 to 7
2026-06-22 14:17:11 -03:00
ruihan 739ecaf86d docs: fix lang toggle hover pointer-events bug 2026-06-20 18:42:54 -03:00
ruihan 996d37b555 docs: fix lang toggle — move to layout instead of markdown include 2026-06-20 18:29:05 -03:00
ruihan 34c2a80bc0 docs: add EN/PT language toggle and Portuguese pages (index, guide, faq) 2026-06-20 18:21:16 -03:00
ruihan 01438e5adf docs: expand site with multi-page guide, FAQ, scenarios, architecture deep-dive 2026-06-20 17:28:10 -03:00
ruihan 9dce6d9301 Add missing history/history-clear to docs 2026-06-20 16:23:44 -03:00
ruihan a81d4533a5 Remove stray test artifact utput=xml.plist 2026-06-20 15:41:17 -03:00
ruihan 7d1adcc9a1 Fix tests: 78/78 passing, fix function names, fix EUID readonly, fix missing functions 2026-06-20 15:41:08 -03:00
ruihan ec824ccd23 Update docs for v2.0.0, add GPG signing script 2026-06-20 15:26:18 -03:00
ruihan e4f4cfcb44 v2.0.0: init wizard, suggest, remediate, predict, telemetry, discord-bot, Nix, Docker, Jekyll, GPG verify 2026-06-20 15:25:30 -03:00
ruihan b1a12ac051 v1.7.0+v1.8.0: mocks, MA deep scan, Configurator detect, pf backup, disk check 2026-06-20 15:23:07 -03:00
ruihan 6edfa0d5a1 chore(deps): bump actions/checkout from 4 to 7
Bumps [actions/checkout](https://github.com/actions/checkout) from 4 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v4...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-06-20 18:18:41 +00:00
ruihan 51ddececeb Add CI.md with local CI docs, update Makefile with ci target 2026-06-20 15:17:42 -03:00
ruihan 82b0d84fec Add CircleCI config as free CI alternative 2026-06-20 15:17:27 -03:00
ruihan 8837d5b402 v1.6.1: per-command --help, free-CI rewrite, brew audit clean 2026-06-20 15:16:48 -03:00
ruihan 232b155f7d Fix demo.svg typo, remove wiki from main repo, add 6-month ROADMAP.md 2026-06-20 14:42:03 -03:00
ruihan 5a378f78e3 Overhaul docs site: full command reference, architecture guide, troubleshooting 2026-06-20 14:41:18 -03:00
ruihan 0a2e860e80 Add FUNDING.yml, PR template, Dependabot, Makefile, .gitattributes 2026-06-20 14:40:39 -03:00
ruihan 6ad89b810f Create wiki home 2026-06-20 14:40:16 -03:00
ruihan 3f3d647d12 Add project logo/icon to README and docs 2026-06-20 14:23:26 -03:00
ruihan 96f156c3a4 Add terminal demo SVG to docs 2026-06-20 14:06:34 -03:00
ruihan 18befd7e6c Add bats tests for 8 remaining modules: demo, harden, ma_detect, monitor, report, selfupdate, status, vpn 2026-06-20 14:05:17 -03:00
ruihan bda3fcce4d Add macOS 27 to compat list, add terminal demo to docs 2026-06-20 13:32:46 -03:00
ruihan 381540f9a9 v1.6.0: Homebrew tap, Pages, PT-BR docs, 6 new test modules 2026-06-20 13:30:13 -03:00
ruihan 25fac5f43f feat: tests, demo, JSON output, VPN kill-switch, more issue responses
- tests/: bats test suite for 8 modules (suppress, heal, firewall, detect,
  validate, colors, dscl, backup)
- demo: simulated full bypass flow for showcasing (no real changes)
- --json flag for report and audit commands (machine-readable output)
- vpn-kill: pf-based kill-switch that blocks MDM outside VPN tunnel
- vpn-kill-remove / vpn-kill-status: manage the kill-switch
- Responded to 5 more bypass-mdm issues (#135, #141, #150, #151, #154)
- CI now includes all new lib files in ShellCheck
- Bump 1.4.0 -> 1.5.0
2026-06-20 13:07:03 -03:00
ruihan b25ce7f00c feat: doctor, update, uninstall, config, report, MA detect, spinner, reinstall
- doctor: pre-flight diagnostic (sudo, recovery, disk, libs, third-party FW)
- update: self-update from GitHub latest release
- uninstall: remove all Unleash traces (daemons, pf, hosts, backups, config)
- config: persistent settings file (~/.unleash.conf) with show/set/unset
- report: full markdown system status report
- MA detect: scan for Migration Assistant MDM artifacts per user
- spinner: visual progress indicator for long operations
- reinstall: uninstall + persist + whitelist + monitor-install
- Third-party firewall detection (Little Snitch, LuLu, Radio Silence, Vallum)
- Load config on startup (WEBHOOK, LOG_LEVEL, LOG_FILE)
- Bump 1.3.0 -> 1.4.0
2026-06-20 12:23:51 -03:00
ruihan 208fe44dce feat: history, dry-run, Discord webhook, bump 1.3.0
- history: read event logs from monitor/heal
- test/dry-run: simulate bypass, suppress, harden without side effects
- --dry-run: global flag for any command
- monitor --webhook <url>: Discord notification on MDM detection
- Update CHANGELOG, CI, standalone for all new features
- Bump 1.2.0 -> 1.3.0
2026-06-20 12:19:55 -03:00
ruihan f6fa98c6c9 feat: examples, standalone, monitor-install, quickstart
- auto-bypass-usb.sh: one-click bypass from SSD
- prepare-ssd.sh: prepare the SSD before you need it
- build-standalone.sh: now bundles all 12 lib modules (+check, +monitor)
- unleash-standalone.sh: v1.2.0, 1958 lines, all commands included
- monitor-install / monitor-uninstall: monitor as persistent LaunchDaemon
- QUICKSTART.md: Portuguese/English quick reference for SSD
- Responded to 8 more bypass-mdm issues (#136, #137, #139, #145, #148, #153, #155, #172)
- Attached standalone to GitHub Release v1.2.0
2026-06-20 12:14:26 -03:00
ruihan 1e35e5e0ef feat: structured logging, CLI aliases, comprehensive README
- Rewrite colors.sh with proper log levels ([INF], [ OK], [WRN], etc.)
- Add timestamps, --verbose debug mode, --log-file support
- Add begin()/end_ok()/end_fail() progress bar helpers
- Add command aliases (by, sv, st, fw, wl, mn, etc.)
- Rewrite help with categorized command listing
- Write comprehensive README covering every command, layer, scenario
- All syntax verified with bash -n
2026-06-20 12:10:24 -03:00
ruihan 789985d191 feat: add check and monitor commands + repo About section
- check: pre-format/pre-upgrade MDM assessment with clear SAFE/DETECTED output
- monitor: background daemon (5min interval) with osascript notifications
- monitor-stop / monitor-status: control the daemon
- Updated repo description (About) and topics on GitHub
- Updated README, CHANGELOG, CI for both commands
- Bump 1.1.0 -> 1.2.0
2026-06-20 12:06:21 -03:00
ruihan 06e4423b4f humanize: remove AI artifacts from code and docs
- Strip all '# unleash/lib/' file header comments
- Strip section comment blocks from main script
- Rewrite README from 625 to 140 lines (no badges, TOC, tables, ASCII art)
- Inline readonly arrays in whitelist.sh
- Fix help command (was parsing removed header comments)
- Squeeze double blank lines
2026-06-20 12:01:43 -03:00
ruihan b96d86cc38 chore: professionalize project for community contributions
- Add CONTRIBUTING.md with guidelines for PRs and issues
- Add CODE_OF_CONDUCT.md (Contributor Covenant v2.1)
- Add SECURITY.md with vulnerability reporting policy
- Add CHANGELOG.md for version tracking
- Add GitHub issue templates (bug, feature, compatibility)
- Add GitHub Actions CI (ShellCheck, syntax check, markdown lint)
- Add .gitignore for backup dirs and OS artifacts
- Update README with badges and new commands
- Bump version to 1.1.0
- Update comparison table with new features
2026-06-20 11:59:22 -03:00
ruihan e0dee7cfcc feat: add firewall, harden, audit, whitelist commands
- firewall: pf kernel-level block of Apple MDM IP ranges (DoH-proof)
- firewall-off: remove pf MDM block and restore pf.conf
- harden: live-OS hardening (kill MDM processes, remove profiles, flush DNS)
- audit: deep MDM audit (profiles, certs, launch agents, processes, risk scoring)
- whitelist: selective block (block MDM only, preserve iCloud/App Store)
- status: upgraded with deep audit mode and risk assessment
- Interactive menus updated for all new commands
2026-06-20 11:58:00 -03:00
ruihan 3fb1090839 feat: add heal, persist, unpersist commands with LaunchDaemon support
- New 'heal' command: checks MDM suppression state and re-applies if needed
- New 'persist' command: installs LaunchDaemon for boot-time auto-heal
- New 'unpersist' command: removes the persistence LaunchDaemon
- Interactive menu updated for all new commands
- Heal works from both Recovery and booted system (sudo)
- Updated README with full documentation for heal/persist/unpersist
- macOS Tahoe 26.x added to compatibility list
2026-06-20 10:19:39 -03:00
ruihan df91070b3f feat: add axm-adm-mdm domain block, DFU/IPSW restore guide, T2 docs
- Add axm-adm-mdm.apple.com to domain block list (Apple Configurator MDM)
- Add DFU/IPSW firmware restore procedure to troubleshooting
- Add Intel T2 Mac documentation section
- Update domain table in README
2026-06-20 10:08:32 -03:00
ruihan b8e79b66a3 feat: suppress user-level MDM artifacts, expand domain/daemon lists
- Add user home directory MDM artifact cleanup (preferences, caches, launch agents)
- Expand domain blocking (albert, gdmf, configuration, xp, gs, tb, vpp, init-content)
- Add 2 more launchd overrides (ManagedClient.cloudConfiguration, activationd)
- Rewrite README as comprehensive documentation with troubleshooting guide
2026-06-20 09:57:46 -03:00
ruihan cdce779763 Initial commit: unleash v1.0.0
Unified MDM bypass tool for macOS.

- CLI with 7 subcommands (bypass/suppress/backup/restore/dualboot/status/version)
- Modular (lib/*.sh) + standalone (single-file) formats
- Auto-detect Recovery mode, APFS volume, FileVault
- SSV-safe: all writes target Data volume
- Backup/restore original state
- MIT License
2026-06-12 13:40:58 -03:00