chore(macos): add helper scripts and docs

Author: roodboi

README.md

@@ -106,6 +106,15 @@ If the agent cannot run shell commands, use MCP instead: `hack setup mcp` and `h
 
 ### macOS app (experimental)
 Source lives in `apps/macos`. See `apps/macos/README.md` for XcodeGen and build/run steps.
+Quick commands (repo root):
+
+```bash
+bun run macos:project-gen
+bun run macos:open
+bun run macos:dev
+bun run macos:build
+bun run macos:test
+```
 
 ### Configuration (.hack/hack.config.json)
 - `name`: project slug (also used for Docker Compose project name)

apps/macos/App/Info.plist

@@ -2,12 +2,20 @@
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
-  <key>CFBundleName</key>
-  <string>Hack Desktop</string>
+  <key>CFBundleDevelopmentRegion</key>
+  <string>$(DEVELOPMENT_LANGUAGE)</string>
   <key>CFBundleDisplayName</key>
   <string>Hack Desktop</string>
+  <key>CFBundleExecutable</key>
+  <string>$(EXECUTABLE_NAME)</string>
   <key>CFBundleIdentifier</key>
   <string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+  <key>CFBundleInfoDictionaryVersion</key>
+  <string>6.0</string>
+  <key>CFBundleName</key>
+  <string>$(PRODUCT_NAME)</string>
+  <key>CFBundlePackageType</key>
+  <string>APPL</string>
   <key>CFBundleShortVersionString</key>
   <string>$(MARKETING_VERSION)</string>
   <key>CFBundleVersion</key>

apps/macos/README.md

@@ -8,6 +8,23 @@ Native macOS app for managing local hack projects and daemon status.
 - Xcode 15.1+
 - XcodeGen (`brew install xcodegen`)
 
+## What it does
+
+- Lists local hack projects with status and details.
+- Actions: start/stop project, open URL, open logs (stub).
+- Shows hackd status with start/stop controls.
+- Menu bar item for quick status + actions.
+
+## Quick commands (repo root)
+
+```bash
+bun run macos:project-gen
+bun run macos:open
+bun run macos:dev
+bun run macos:build
+bun run macos:test
+```
+
 ## Generate the Xcode project
 
 ```bash
@@ -32,3 +49,13 @@ Open `HackDesktop.xcodeproj` in Xcode and run the app. The app uses the `hack` C
 
 If `hack` is not in PATH for GUI apps, ensure it lives in `/opt/homebrew/bin` or
 `/usr/local/bin` (both are added to PATH by the app).
+
+## Data source
+
+The app shells out to `hack` for JSON data (projects + daemon status). It does not
+talk to hackd directly yet.
+
+## Logs
+
+The logs view is a stub placeholder for now. It can be wired to `hack logs` or
+daemon streaming later.

package.json

@@ -15,6 +15,11 @@
     "install:bin": "bun run build && bun run scripts/install-cli.ts --mode=bin --force",
     "install:status": "bun run scripts/install-status.ts",
     "lint": "bun run scripts/lint.ts",
+    "macos:project-gen": "cd apps/macos && xcodegen -c project.yml",
+    "macos:open": "open apps/macos/HackDesktop.xcodeproj",
+    "macos:dev": "bun run macos:project-gen && bun run macos:open",
+    "macos:build": "cd apps/macos && swift build",
+    "macos:test": "cd apps/macos && swift test",
     "prepare": "husky",
     "release:prepare": "bunx semantic-release --no-ci",
     "typecheck": "bunx tsc -p tsconfig.json --noEmit",