From 4426bf2615b744e4b66f5919d41129e83c1d3daf Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Sat, 6 Dec 2025 23:45:17 +0000
Subject: [PATCH] Docs: note SIGN_IDENTITY for mac signing

---
 README.md           | 1 +
 docs/mac/signing.md | 4 ++++
 2 files changed, 5 insertions(+)

diff --git a/README.md b/README.md
index 51823969a..c36f9d2a5 100644
--- a/README.md
+++ b/README.md
@@ -44,6 +44,7 @@ Because every space lobster needs a time-and-space machine. The Doctor has a TAR
 Only the Pi/Tau CLI is supported now; legacy Claude/Codex/Gemini paths have been removed.
 
 ## Quick Start
+Mac signing tip: set `SIGN_IDENTITY="Apple Development: Your Name (TEAMID)"` in your shell profile so `scripts/restart-mac.sh` signs with your cert (defaults to ad-hoc). Debug bundle ID remains `com.steipete.clawdis.debug`.
 
 ```bash
 # Install
diff --git a/docs/mac/signing.md b/docs/mac/signing.md
index e717a9aa2..cb109da30 100644
--- a/docs/mac/signing.md
+++ b/docs/mac/signing.md
@@ -6,6 +6,7 @@ This app is usually built from `scripts/package-mac-app.sh`, which now:
 - writes the Info.plist with that bundle id (override via `BUNDLE_ID=...`)
 - calls `scripts/codesign-mac-app.sh` to sign the main binary, bundled CLI, and app bundle so macOS treats each rebuild as the same signed bundle and keeps TCC permissions (notifications, accessibility, screen recording, mic, speech). Defaults to ad‑hoc; set `SIGN_IDENTITY="Developer ID Application: …"` to use a real cert.
 - injects build metadata into Info.plist: `ClawdisBuildTimestamp` (UTC) and `ClawdisGitCommit` (short hash) so the About pane can show build, git, and debug/release channel.
+- reads `SIGN_IDENTITY` from the environment. Add `export SIGN_IDENTITY="Apple Development: Your Name (TEAMID)"` (or your Developer ID Application cert) to your shell rc to always sign with your cert; otherwise signing falls back to ad‑hoc.
 
 ## Usage
 
@@ -13,6 +14,9 @@ This app is usually built from `scripts/package-mac-app.sh`, which now:
 # from repo root
 scripts/package-mac-app.sh               # ad-hoc signing
 SIGN_IDENTITY="Developer ID Application: Your Name" scripts/package-mac-app.sh   # real cert
+
+# set it once in your shell profile for convenience
+echo 'export SIGN_IDENTITY="Apple Development: Your Name (TEAMID)"' >> ~/.zshrc
 ```
 
 If you need a different bundle id (e.g. release build):