#3534: Update ad-hoc signing instructions in dev setup
docs
app: macos
Cluster:
Build and Fix Enhancements
Clarify instructions for using ad-hoc signing in the packaging script.
Without this flag, macos will report building failure.
<!-- greptile_comment -->
<h2>Greptile Overview</h2>
<h3>Greptile Summary</h3>
This PR updates the macOS developer setup guide to clarify how to build/package the app without an Apple Developer ID certificate by explicitly opting into ad-hoc signing via `ALLOW_ADHOC_SIGNING=1` when running `scripts/package-mac-app.sh`.
This aligns the dev-setup docs with the packaging/signing scripts’ behavior (ad-hoc signing is an explicit opt-in) and points developers to the macOS app README for deeper signing/run-mode troubleshooting.
<h3>Confidence Score: 5/5</h3>
- This PR is safe to merge; it’s a small, localized documentation clarification.
- Only one markdown file is updated, and the new instruction (`ALLOW_ADHOC_SIGNING=1 ./scripts/package-mac-app.sh`) matches existing documented/scripted behavior elsewhere in the repo (e.g., mac signing docs and macOS app README). No code or config changes are introduced.
- No files require special attention
<!-- greptile_other_comments_section -->
<sub>(2/5) Greptile learns from your feedback when you react with thumbs up/down!</sub>
**Context used:**
- Context from `dashboard` - CLAUDE.md ([source](https://app.greptile.com/review/custom-context?memory=fd949e91-5c3a-4ab5-90a1-cbe184fd6ce8))
- Context from `dashboard` - AGENTS.md ([source](https://app.greptile.com/review/custom-context?memory=0d0c8278-ef8e-4d6c-ab21-f5527e322f13))
<!-- /greptile_comment -->
Most Similar PRs
#3337: fix(macos-app): patch SwiftPM Bundle.module accessor for app bundle
by skymoore · 2026-01-28
78.5%
#18792: docs: add macOS source-run troubleshooting for setup/auth issues
by yash27-lab · 2026-02-17
77.2%
#6235: fix: from source development command
by witcxc · 2026-02-01
76.5%
#3973: fix: enhance npm package integrity checks and include critical files
by YeSuX · 2026-01-29
76.1%
#11048: fix: address repository issues (env, author, CI comments, security ...
by cavula · 2026-02-07
76.0%
#13864: fix(docs): update macOS VM installation instructions for clarity an...
by skmpf · 2026-02-11
75.0%
#7121: feat(macos): update app icon OpenClaw branding
by rishavgoenka · 2026-02-02
74.6%
#7083: 说明文档
by 1213718318 · 2026-02-02
74.4%
#7701: Update README.md
by stephenchen2025 · 2026-02-03
74.1%
#15909: Guard notifications on macOS; fix focus issue and build fixes
by jasonkneen · 2026-02-14
73.9%