#23673: docs(imessage): update cliPath to Homebrew path for Apple Silicon
docs
channel: imessage
size: XS
Cluster:
Browser Security Enhancements
## Summary
- **Problem:** The iMessage channel docs showed `/usr/local/bin/imsg` as the `cliPath`, which is the legacy Intel Homebrew path. On Apple Silicon Macs (M1/M2/M3+) — now the majority of new Mac hardware — Homebrew installs to `/opt/homebrew/bin`, causing "binary not found" failures for users following the docs.
- **Why it matters:** First-time setup on Apple Silicon breaks silently if the user copies the config verbatim.
- **What changed:** Updated one line in `docs/channels/imessage.md`: `cliPath` example from `/usr/local/bin/imsg` → `/opt/homebrew/bin/imsg`.
- **What did NOT change:** No runtime code, no config schema, no behavior. Intel Mac users can still override to `/usr/local/bin/imsg` manually.
## Change Type (select all)
- [ ] Bug fix
- [ ] Feature
- [ ] Refactor
- [X] Docs
- [ ] Security hardening
- [ ] Chore/infra
## Scope (select all touched areas)
- [ ] Gateway / orchestration
- [ ] Skills / tool execution
- [ ] Auth / tokens
- [ ] Memory / storage
- [X] Integrations
- [ ] API / contracts
- [ ] UI / DX
- [ ] CI/CD / infra
## Linked Issue/PR
- Closes #
- Related #
## User-visible / Behavior Changes
Users following `docs/channels/imessage.md` on Apple Silicon Macs will now have the correct default `cliPath` for their Homebrew installation. Intel Mac users are unaffected (they set `cliPath: "/usr/local/bin/imsg"` manually if needed).
## Security Impact (required)
- New permissions/capabilities? No
- Secrets/tokens handling changed? No
- New/changed network calls? No
- Command/tool execution surface changed? No
- Data access scope changed? No
## Repro + Verification
### Environment
- OS: macOS (Apple Silicon — M1/M2/M3)
- Runtime/container: Node / native
- Model/provider: N/A (docs-only)
- Integration/channel: iMessage
- Relevant config (redacted):
```yaml
channels:
imessage:
enabled: true
cliPath: "/opt/homebrew/bin/imsg"
<!-- greptile_comment -->
<h3>Greptile Summary</h3>
Updated `cliPath` example in iMessage channel docs from `/usr/local/bin/imsg` (Intel Homebrew path) to `/opt/homebrew/bin/imsg` (Apple Silicon Homebrew path).
- Aligns documentation with current Mac hardware (M1/M2/M3 now majority)
- Prevents "binary not found" errors for users following docs verbatim on Apple Silicon
- Intel Mac users can still manually override to `/usr/local/bin/imsg` if needed
- No runtime code, config schema, or behavior changes
<h3>Confidence Score: 5/5</h3>
- This PR is safe to merge with no risk
- Documentation-only change updating a single file path example to match current Apple Silicon Homebrew standard. No code, tests, or runtime behavior affected. The change is factually correct and improves user experience.
- No files require special attention
<sub>Last reviewed commit: fb36641</sub>
<!-- greptile_other_comments_section -->
<sub>(2/5) Greptile learns from your feedback when you react with thumbs up/down!</sub>
<!-- /greptile_comment -->
Most Similar PRs
#18792: docs: add macOS source-run troubleshooting for setup/auth issues
by yash27-lab · 2026-02-17
73.3%
#11048: fix: address repository issues (env, author, CI comments, security ...
by cavula · 2026-02-07
72.7%
#20584: fix: use stable Homebrew symlink for daemon node path
by mwfj · 2026-02-19
72.4%
#21271: fix(commands): pass channel/capabilities/shell/os to runtime in com...
by evansantos · 2026-02-19
71.9%
#22632: docs: fix redirects and small reorg
by gianpaj · 2026-02-21
71.5%
#23308: fix(browser): accept upload paths that traverse symlinked tmp dirs
by SidQin-cyber · 2026-02-22
71.2%
#17951: fix: macOS app: Skill binary detection does not respect /etc/paths ...
by MisterGuy420 · 2026-02-16
71.2%
#17929: fix(skills): augment PATH with /etc/paths on macOS for binary detec...
by lailoo · 2026-02-16
70.8%
#6064: fix(daemon): prefer bundled node from install-cli.sh over system node
by joyshmitz · 2026-02-01
70.8%
#18112: fix(daemon): gateway install on macOS ignores fnm/nvm node (#18090)
by yinghaosang · 2026-02-16
70.5%