Skip to content

Document macOS Gatekeeper workaround for manual CodeWhale binaries #2139

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
Copilot wants to merge 2 commits into
base: main
Choose a base branch
from
+15 −0
Draft

Document macOS Gatekeeper workaround for manual CodeWhale binaries #2139

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
52b4fdb
Initial plan
Copilot May 25, 2026
2bf8450
docs: note macOS Gatekeeper warning
Copilot May 25, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,10 @@ docker run --rm -it \
> `https://github.com/Hmbown/CodeWhale/releases`. For manual downloads,
> verify the SHA-256 manifest and avoid look-alike repositories or search-result
> mirrors. See [download safety and checksums](docs/INSTALL.md#2-download-safety-and-checksums).
>
> macOS Gatekeeper: standalone downloads from a browser may show "Apple cannot verify"
> warnings. Clear the quarantine attribute on both binaries:
> `xattr -d com.apple.quarantine ~/.local/bin/codewhale ~/.local/bin/codewhale-tui`.

Already installed? Use the updater that matches the install path:

Expand Down
4 changes: 4 additions & 0 deletions README.zh-CN.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,10 @@ docker run --rm -it \
> `https://github.com/Hmbown/CodeWhale/releases`。手动下载时请校验
> SHA-256 manifest，并避免相似仓库名或搜索结果里的镜像站。详见
> [下载安全与校验](docs/INSTALL.md#2-download-safety-and-checksums)。
>
> macOS Gatekeeper：用浏览器手动下载时，可能会提示“Apple 无法验证”。
> 这时可清理二进制的隔离属性：
> `xattr -d com.apple.quarantine ~/.local/bin/codewhale ~/.local/bin/codewhale-tui`。

已经安装过？按你的安装方式更新：

Expand Down
7 changes: 7 additions & 0 deletions docs/INSTALL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -266,6 +266,13 @@ chmod +x ~/.local/bin/codewhale ~/.local/bin/codewhale-tui
codewhale --version
```

> **macOS Gatekeeper note.** If you downloaded the binaries with a browser,
> macOS may block them with "Apple cannot verify" warnings. Clear the quarantine
> attribute on both binaries and retry:
> ```bash
> xattr -d com.apple.quarantine ~/.local/bin/codewhale ~/.local/bin/codewhale-tui 2>/dev/null || true
> ```

Verify integrity against the per-release SHA-256 manifest:

```bash
Expand Down