Repository navigation
usage_kun v0.2.1
usage_kun v0.2.1
This is a packaging and hardening release. There are no feature changes.
Fixed
- The release
UsageKun-macOS.zipnow contains a properly signed app bundle. Previous releases shipped a binary that only carried the linker's bare ad-hoc signature (no sealed resources,Info.plistnot bound), so Gatekeeper rejected downloaded copies as "damaged and can't be opened".Scripts/package_app.shnow strips extended attributes and re-signs the whole bundle with a full ad-hoc signature (hardened runtime enabled), and verifies it withcodesign --verify --strict. - The release zip no longer archives filesystem extended attributes as AppleDouble
._*files, which could invalidate the sealed signature after extraction.Scripts/package_release_zip.shalso round-trips the archive and re-verifies the signature before publishing.
Hardening
- The Codex local databases (
~/.codex/state_5.sqlite,~/.codex/logs_2.sqlite) are now opened withsqlite3 -readonly -batch, so usage_kun can never write to, or leave lock/journal files next to, another app's database. - The CI workflow's
GITHUB_TOKENis now restricted tocontents: read.
Docs
- README (English and Japanese) now documents installing from the release zip, including the expected one-time Gatekeeper approval for a non-notarized app.
First Launch: "Apple could not verify UsageKun is free of malware"
The app is signed but not notarized, so the first launch of a downloaded copy still shows a Gatekeeper warning ("Apple could not verify "UsageKun" is free of malware..."). This is expected for any non-notarized app and is different from the previous "damaged" error, which prevented the app from being opened at all. Approve it once:
- In the warning dialog, click Done (do NOT click "Move to Trash").
- Open System Settings > Privacy & Security.
- Scroll down to the Security section, where "UsageKun" is listed as blocked.
- Click Open Anyway, then confirm with Open Anyway again and authenticate.
日本語: 初回起動時に「Apple は、"UsageKun" にマルウェアが含まれていないことを確認できませんでした」と表示された場合:
- 警告 dialog で 「完了」 を押します(「ゴミ箱に入れる」は押さないでください)。
- システム設定 > プライバシーとセキュリティ を開きます。
- 下にスクロールし、セキュリティ 欄の「"UsageKun" はブロックされました」の横の 「このまま開く」 を押します。
- 確認 dialog でもう一度 「このまま開く」 を押し、Touch ID または password で認証します。
Alternatively, from Terminal: xattr -d com.apple.quarantine /Applications/UsageKun.app
The approval is needed only once per downloaded version.