ruihan
fa3f0a1d38
docs: remove upstream issue references
2026-11-09 10:14:14 +08:00
ruihan
205f2faf02
rename project to runaway
2026-11-09 10:13:51 +08:00
ruihan
20946dd445
fix(accounts): assign new homes to the target user
...
Assign new home directories to the target user
2026-10-30 12:00:07 -03:00
ruihan
be63e223b6
fix(accounts): assign new homes to the target user
2026-10-30 11:59:18 -03:00
ruihan
5dbd28d280
docs: record macOS 27 reports and Wi-Fi investigation steps
...
Document macOS 27 reports and Wi-Fi investigation steps
2026-10-30 11:49:15 -03:00
ruihan
eca2592797
docs: record macOS 27 reports and Wi-Fi investigation steps
2026-10-30 11:48:40 -03:00
ruihan
e1dbc8f5e1
fix(dualboot): keep passwords out of diagnostics
...
Keep dualboot passwords out of diagnostics and logs
2026-10-30 11:46:18 -03:00
ruihan
6623b00b2a
fix(dualboot): keep account passwords out of diagnostics
2026-10-30 11:37:50 -03:00
ruihan
1c4f2f4094
fix(doctor): preserve network query failure states
...
Distinguish failed network queries from missing Wi-Fi
2026-10-30 11:36:37 -03:00
ruihan
5a7c832b9e
fix(doctor): distinguish failed queries from missing Wi-Fi
2026-10-30 11:34:53 -03:00
ruihan
6d92f448f9
fix(cli): avoid target access during previews
...
Return before volume access in suppression previews
2026-10-30 11:33:30 -03:00
ruihan
ec1da9c4d7
fix(cli): skip volume access during suppression previews
2026-10-30 11:31:43 -03:00
ruihan
0d30daf810
fix(suppress): tolerate absent activation metadata
...
Allow absent optional activation metadata during suppression
2026-10-30 11:28:50 -03:00
ruihan
44fde9cd2a
fix(suppress): tolerate absent optional activation metadata
2026-10-30 11:26:57 -03:00
ruihan
d56bc3c25e
feat(admin): add a Recovery-only local account command
...
Add a Recovery-only local admin command
2026-10-30 11:16:00 -03:00
ruihan
aba073e8b5
fix(admin): stop dry runs before resolving the target volume
2026-10-30 11:13:58 -03:00
ruihan
405fc18fc0
Merge remote-tracking branch 'origin/main' into integrate
2026-10-30 11:13:55 -03:00
ruihan
14948c54da
fix(recovery): download the standalone entrypoint
...
Download the standalone script in Recovery instructions
2026-10-30 11:13:22 -03:00
ruihan
655c817402
test(recovery): run the documented download without libraries
2026-10-30 11:12:07 -03:00
ruihan
69779f8e2d
Merge remote-tracking branch 'origin/main' into integrate
2026-10-30 11:12:04 -03:00
ruihan
e403fb29ce
fix(profiles): keep preflight queries read-only
...
Keep preflight profile queries read-only and numeric
2026-10-30 11:11:39 -03:00
ruihan
6bdef49a05
test(audit): reject arithmetic diagnostics across Bash versions
2026-10-30 11:10:22 -03:00
ruihan
c9014c9b36
fix(profiles): keep preflight queries read-only and numeric
2026-10-30 11:10:22 -03:00
ruihan
460ed05a1f
fix(doctor): expose read-only build and Wi-Fi diagnostics
...
Expose read-only macOS build and Wi-Fi diagnostics
2026-10-30 11:10:04 -03:00
ruihan
0c575bf34d
fix(doctor): expose read-only build and Wi-Fi diagnostics
2026-10-30 11:08:20 -03:00
ruihan
adc3305ec7
fix(dualboot): stop dry runs before target access
...
Return before target access in dualboot dry runs
2026-10-30 11:08:00 -03:00
ruihan
7bc9cddc6d
fix(dualboot): stop dry runs before accessing target state
2026-10-30 11:06:23 -03:00
ruihan
8aeb0615fa
fix(rosetta): repair generated hosts blocks
...
Restore Rosetta access in generated hosts blocks
2026-10-30 11:04:45 -03:00
ruihan
e1d0045ab0
fix(heal): restore Rosetta access on intact installations
2026-10-30 11:03:00 -03:00
ruihan
f84fe0986b
fix(suppression): repair generated Rosetta hosts blocks
2026-10-30 11:03:00 -03:00
ruihan
9fb8ba86ac
Merge remote-tracking branch 'origin/main' into integrate/rosetta
2026-10-30 11:02:58 -03:00
ruihan
51fa261e77
fix(audit): emit valid zero counts
...
Emit valid zero counts in profile audits
2026-10-30 11:02:36 -03:00
ruihan
79d80c9386
fix(audit): emit valid zero counts without nounset failures
2026-10-30 11:01:17 -03:00
ruihan
14534947b9
fix(monitor): preserve literal daemon arguments
...
Preserve the monitor script path in launchd arguments
2026-10-30 11:00:54 -03:00
ruihan
10762a286f
fix(monitor): preserve literal daemon script arguments
2026-10-30 10:58:28 -03:00
ruihan
a54b8205ad
fix(persistence): invoke the installed script literally
...
Invoke the installed script path literally from launchd
2026-10-30 10:58:13 -03:00
ruihan
f4ff96bfd3
fix(persistence): invoke the installed script path literally
2026-10-30 10:57:04 -03:00
ruihan
644ba62438
fix(cli): preserve optional argument boundaries
...
Preserve CLI argument boundaries and optional values
2026-10-30 10:56:49 -03:00
ruihan
579ce6cb2e
fix(cli): preserve optional argument boundaries
2026-10-30 10:55:34 -03:00
ruihan
c7ce72436b
fix(volumes): keep mount diagnostics out of paths
...
Keep disk mount output out of captured volume paths
2026-10-30 10:55:16 -03:00
ruihan
bc91e4ecd5
fix(volumes): keep mount diagnostics out of captured paths
2026-10-30 10:54:06 -03:00
ruihan
fea35a6dae
fix(logging): keep diagnostics out of captured values
...
Keep diagnostics out of captured helper output
2026-10-30 10:53:29 -03:00
ruihan
74f65ad981
merge: reconcile logging regressions with local validation
2026-10-30 10:52:25 -03:00
ruihan
dd983ebd50
fix(validation): restore local shell gates
...
Validate all shell sources and isolate platform fixtures before accepting maintenance changes.
2026-10-30 10:51:35 -03:00
ruihan
7bc57d860f
test(fixtures): allow the active test temporary directory
2026-10-30 04:31:38 -03:00
ruihan
8a560b8e6e
fix(validation): restore isolated local checks
2026-10-30 04:21:56 -03:00
ruihan
993db74118
test(suppression): assert the Rosetta block lookup status
2026-10-30 03:56:33 -03:00
ruihan
7ca3d4f2d4
fix(suppression): preserve access to Rosetta configuration
2026-10-30 03:56:14 -03:00
ruihan
0f5ce61283
fix(admin): reject account creation outside Recovery
2026-10-30 03:53:32 -03:00
ruihan
d0a797db61
test(logging): keep helper output free of diagnostics
2026-10-30 03:51:08 -03:00
ruihan
23417113f6
docs: update recovery curl command to use standalone script
2026-07-20 13:09:39 +00:00
ruihan
34a07ff172
docs: add admin command section to README
2026-07-20 13:02:00 +00:00
ruihan
38f4409d82
feat: add standalone local administrator creation mode
2026-07-09 15:07:12 +00:00
ruihan
98c42ca7c1
fix: redirect low-level logging functions to STDERR
2026-07-06 01:32:02 +00:00
ruihan
e0f2026a2f
docs: add search, sidebar nav, dedicated pages, PT translations
2026-06-24 11:19:43 -03:00
ruihan
3d8f02e526
ci: auto-update homebrew formula on release publish
...
Adds a release workflow that:
- Triggers on release publish
- Downloads the release artifact
- Computes the correct SHA-256
- Updates homebrew-runaway formula with pinned tag URL and SHA
- Auto-commits and pushes
2026-06-24 09:34:52 -03:00
ruihan
c1b62ddef7
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
94890f2195
docs: fix lang toggle hover pointer-events bug
2026-06-20 18:42:54 -03:00
ruihan
7d6d0b1584
docs: fix lang toggle — move to layout instead of markdown include
2026-06-20 18:29:05 -03:00
ruihan
d10598446e
docs: add EN/PT language toggle and Portuguese pages (index, guide, faq)
2026-06-20 18:21:16 -03:00
ruihan
b675a7cdf5
docs: expand site with multi-page guide, FAQ, scenarios, architecture deep-dive
2026-06-20 17:28:10 -03:00
ruihan
4771089955
Add missing history/history-clear to docs
2026-06-20 16:23:44 -03:00
ruihan
174f0552a1
Remove stray test artifact utput=xml.plist
2026-06-20 15:41:17 -03:00
ruihan
16ba4b83ae
Fix tests: 78/78 passing, fix function names, fix EUID readonly, fix missing functions
2026-06-20 15:41:08 -03:00
ruihan
9f25ecdd67
Update docs for v2.0.0, add GPG signing script
2026-06-20 15:26:18 -03:00
ruihan
3d271d3dc1
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
6d1617c3ae
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
8006282824
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
a345ea5898
Add CI.md with local CI docs, update Makefile with ci target
2026-06-20 15:17:42 -03:00
ruihan
81ab921e3d
Add CircleCI config as free CI alternative
2026-06-20 15:17:27 -03:00
ruihan
291e063d33
v1.6.1: per-command --help, free-CI rewrite, brew audit clean
2026-06-20 15:16:48 -03:00
ruihan
3a20bb5010
Fix demo.svg typo, remove wiki from main repo, add 6-month ROADMAP.md
2026-06-20 14:42:03 -03:00
ruihan
b3ce1f162b
Overhaul docs site: full command reference, architecture guide, troubleshooting
2026-06-20 14:41:18 -03:00
ruihan
bb9125e26b
Add FUNDING.yml, PR template, Dependabot, Makefile, .gitattributes
2026-06-20 14:40:39 -03:00
ruihan
9410e0c9c0
Create wiki home
2026-06-20 14:40:16 -03:00
ruihan
ec3af15ebb
Add project logo/icon to README and docs
2026-06-20 14:23:26 -03:00
ruihan
a277481ff2
Add terminal demo SVG to docs
2026-06-20 14:06:34 -03:00
ruihan
1e63f819bd
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
008c7c5128
Add macOS 27 to compat list, add terminal demo to docs
2026-06-20 13:32:46 -03:00
ruihan
b14430ee32
v1.6.0: Homebrew tap, Pages, PT-BR docs, 6 new test modules
2026-06-20 13:30:13 -03:00
ruihan
1791f6d321
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
- 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
33e83f8d63
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 the latest release
- uninstall: remove all Runaway traces (daemons, pf, hosts, backups, config)
- config: persistent settings file (~/.runaway.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
5cfcf6f748
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
8defc9c7cc
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)
- runaway-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
- Attached standalone to Release v1.2.0
2026-06-20 12:14:26 -03:00
ruihan
7c66f6bd8f
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
b8759a2acc
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
- Updated README, CHANGELOG, CI for both commands
- Bump 1.1.0 -> 1.2.0
2026-06-20 12:06:21 -03:00
ruihan
c05598b051
humanize: remove AI artifacts from code and docs
...
- Strip all '# runaway/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
ca7b8b0079
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 issue templates (bug, feature, compatibility)
- Add 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
58b96c4e11
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
2476af12e0
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
1aaac36484
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
677993cf76
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
ee84b445c8
Initial commit: runaway 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