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