poke-gate 0.0.3 → 0.0.5

package/.github/workflows/release.yml

@@ -0,0 +1,124 @@
+name: Build & Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    runs-on: macos-26
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Get version from tag
+        id: version
+        run: |
+          TAG="${GITHUB_REF#refs/tags/}"
+          VERSION="${TAG#v}"
+          echo "tag=${TAG}" >> "$GITHUB_OUTPUT"
+          echo "number=${VERSION}" >> "$GITHUB_OUTPUT"
+
+      - name: Update app version in Xcode project
+        run: |
+          sed -i '' "s/MARKETING_VERSION = .*;/MARKETING_VERSION = ${{ steps.version.outputs.number }};/g" "clients/Poke macOS Gate/Poke macOS Gate.xcodeproj/project.pbxproj"
+
+      - name: Commit version bump
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add "clients/Poke macOS Gate/Poke macOS Gate.xcodeproj/project.pbxproj"
+          git commit -m "Bump version to ${{ steps.version.outputs.number }}" || echo "No changes to commit"
+          git push origin HEAD:refs/heads/main || echo "Push skipped"
+
+      - name: Select Xcode
+        run: sudo xcode-select -s /Applications/Xcode_26.0.app/Contents/Developer
+
+      - name: Build universal app
+        run: |
+          chmod +x build.sh
+          ./build.sh
+
+      - name: Upload DMG to GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: "build/release/Poke.macOS.Gate.dmg"
+          name: Poke Gate ${{ steps.version.outputs.tag }}
+          draft: false
+          prerelease: false
+          generate_release_notes: true
+          body: |
+            ## Installation
+
+            1. Download **Poke.macOS.Gate.dmg** below
+            2. Open the DMG and drag **Poke macOS Gate** to Applications
+            3. Since the app is not notarized, macOS may block it on first launch. Run:
+
+            ```
+            xattr -cr /Applications/Poke\ macOS\ Gate.app
+            ```
+
+            Then open Poke macOS Gate from your menu bar.
+
+            Or install via Homebrew:
+
+            ```
+            brew install f/tap/poke-gate
+            ```
+
+            ## CLI alternative
+
+            ```
+            npx poke-gate
+            ```
+
+      - name: Compute DMG SHA256
+        id: sha
+        run: echo "sha256=$(shasum -a 256 'build/release/Poke.macOS.Gate.dmg' | awk '{print $1}')" >> "$GITHUB_OUTPUT"
+
+      - name: Update Homebrew Cask tap
+        env:
+          TAP_REPO_TOKEN_HOMEBREW: ${{ secrets.TAP_REPO_TOKEN_HOMEBREW }}
+          VERSION: ${{ steps.version.outputs.tag }}
+          SHA256: ${{ steps.sha.outputs.sha256 }}
+        run: |
+          VERSION_NUM="${VERSION#v}"
+          git clone https://x-access-token:${TAP_REPO_TOKEN_HOMEBREW}@github.com/f/homebrew-tap.git tap
+          mkdir -p tap/Casks
+          cat > tap/Casks/poke-gate.rb << EOF
+          cask "poke-gate" do
+            version "${VERSION_NUM}"
+            sha256 "${SHA256}"
+
+            url "https://github.com/f/poke-gate/releases/download/${VERSION}/Poke.macOS.Gate.dmg"
+            name "Poke Gate"
+            desc "macOS menu bar app to expose your machine to your Poke AI assistant"
+            homepage "https://github.com/f/poke-gate"
+
+            depends_on macos: ">= :sequoia"
+
+            app "Poke macOS Gate.app"
+
+            postflight do
+              system_command "/usr/bin/xattr", args: ["-cr", "#{appdir}/Poke macOS Gate.app"]
+            end
+
+            zap trash: [
+              "~/Library/Preferences/dev.fka.Poke-macOS-Gate.plist",
+              "~/Library/Saved Application State/dev.fka.Poke-macOS-Gate.savedState",
+              "~/.config/poke-gate",
+            ]
+          end
+          EOF
+          cd tap
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add .
+          git commit -m "Update poke-gate to ${VERSION}"
+          git push

package/README.md

@@ -1,16 +1,54 @@
-# 🚪 poke-gate
+<p align="center">
+  <img src="assets/logo.png" width="128" height="128" alt="Poke Gate icon">
+</p>
 
-Expose your machine to your [Poke](https://poke.com) AI assistant via MCP tunnel.
+<h1 align="center">Poke Gate</h1>
 
-Run `poke-gate` on your machine, then ask Poke from iMessage, Telegram, or SMS to run commands, read files, check system status — anything you'd do in a terminal.
+<p align="center">
+  Let your <a href="https://poke.com">Poke</a> AI assistant access your machine.<br>
+  <sub>A community project — not affiliated with Poke or The Interaction Company.</sub>
+</p>
 
-## Quick start
+<p align="center">
+  <a href="https://github.com/f/poke-gate/releases/latest"><img src="https://img.shields.io/github/v/release/f/poke-gate?style=flat-square" alt="Latest Release"></a>
+  <a href="https://www.npmjs.com/package/poke-gate"><img src="https://img.shields.io/npm/v/poke-gate?style=flat-square" alt="npm"></a>
+  <a href="https://github.com/f/poke-gate/blob/main/LICENSE"><img src="https://img.shields.io/github/license/f/poke-gate?style=flat-square" alt="License"></a>
+  <img src="https://img.shields.io/badge/platform-macOS%2015%2B-blue?style=flat-square" alt="Platform">
+</p>
+
+---
+
+Run Poke Gate on your Mac, then message Poke from iMessage, Telegram, or SMS to run commands, read files, take screenshots, and more — all on your machine.
+
+## Install
+
+**Homebrew** (recommended)
+
+```bash
+brew install f/tap/poke-gate
+```
+
+**Manual download**
+
+Download the latest **Poke.macOS.Gate.dmg** from [Releases](https://github.com/f/poke-gate/releases), open it, and drag to Applications. Since the app is not notarized, you may need to run:
+
+```bash
+xattr -cr /Applications/Poke\ macOS\ Gate.app
+```
+
+**CLI** (no macOS app needed)
 
 ```bash
 npx poke-gate
 ```
 
-On first run, you'll paste your API key from [poke.com/kitchen/api-keys](https://poke.com/kitchen/api-keys).
+## Setup
+
+1. Get an API key from [poke.com/kitchen/api-keys](https://poke.com/kitchen/api-keys)
+2. Open Poke Gate from your menu bar and go to **Settings**
+3. Paste your API key and save
+
+The app connects automatically and shows a green dot when ready.
 
 ## How it works
 
@@ -19,82 +57,105 @@ flowchart TD
     A["You message Poke\nfrom iMessage / Telegram / SMS"] --> B["Poke Agent"]
     B --> C["Agent calls MCP tool"]
     C --> D["MCP Tunnel (WebSocket)"]
-    D --> E["poke-gate on your machine"]
-    E --> F["Runs command / reads file / etc."]
+    D --> E["Poke Gate on your Mac"]
+    E --> F["Runs command / reads file / takes screenshot"]
     F --> D
     D --> B
     B --> A
 ```
 
-poke-gate runs a local MCP server and tunnels it to Poke's cloud. When you ask Poke something that needs your machine, the agent calls the tools, poke-gate executes them locally, and the result flows back to your chat.
+Poke Gate runs a local MCP server and tunnels it to Poke's cloud. When you ask Poke something that needs your machine, the agent calls the tools, Poke Gate executes them locally, and the result flows back to your chat.
 
 ## Tools
 
-| Tool | Description |
+| Tool | What it does |
 |------|-------------|
-| `run_command` | Execute any shell command (ls, git, brew, python, curl, etc.) |
-| `read_file` | Read a file's contents |
+| `run_command` | Execute any shell command (ls, git, brew, python, curl…) |
+| `read_file` | Read a text file |
+| `read_image` | Read an image file and return it as base64 |
 | `write_file` | Write content to a file |
 | `list_directory` | List files and directories |
 | `system_info` | OS, hostname, architecture, uptime, memory |
+| `take_screenshot` | Capture the screen (requires Screen Recording permission) |
 
 ## Examples
 
-From iMessage/Telegram, ask Poke:
+From iMessage or Telegram, ask Poke:
 
 - "What's running on port 3000?"
 - "Show me the last 5 git commits in my project"
 - "How much disk space do I have left?"
 - "Read my ~/.zshrc and suggest improvements"
-- "Create a new file called notes.txt with today's meeting notes"
-- "Run the tests in my project"
+- "Take a screenshot of my screen"
+- "Create a file called notes.txt on my Desktop"
 
-## Setup
+## macOS App
+
+The menu bar app manages everything:
+
+- **Status** — green dot when connected, yellow when connecting, red on error
+- **Personalized** — shows "Connected to your Poke, [name]"
+- **Auto-start** — connects on launch if API key is saved
+- **Auto-restart** — reconnects automatically if the connection drops
+- **Settings** — paste your API key
+- **Logs** — view real-time tool calls and connection events
+- **Screen Recording** — prompts for permission on first launch
 
-### Option 1: Interactive (recommended)
+The app runs in the menu bar only (no Dock icon). Quit is the only way to stop it.
+
+### Building from source
+
+Requires macOS 15+ and Xcode 26+.
 
 ```bash
-npx poke-gate
+git clone https://github.com/f/poke-gate.git
+cd poke-gate/clients/Poke\ macOS\ Gate
+open Poke\ macOS\ Gate.xcodeproj
 ```
 
-### Option 2: Environment variable
+Hit **Run** in Xcode, or build from the command line:
+
+```bash
+./build.sh
+```
+
+## CLI usage
+
+If you prefer the command line over the macOS app:
 
 ```bash
-export POKE_API_KEY=your_key_here
 npx poke-gate
 ```
 
+On first run, paste your API key when prompted. Add `--verbose` to see tool calls in real time:
+
+```bash
+npx poke-gate --verbose
+```
+
+Config is stored at `~/.config/poke-gate/config.json`.
+
 ## Security
 
-**poke-gate grants full shell access to your Poke agent.** This means:
+**Poke Gate grants full shell access to your Poke agent.** This means:
 
 - Any command can be run with your user's permissions
 - Files can be read and written anywhere your user has access
 - Only your Poke agent (authenticated by your API key) can reach the tunnel
 
-Only run poke-gate on machines and networks you trust. Stop it with `Ctrl-C` when you don't need it.
-
-## Configuration
-
-Config is stored at `~/.config/poke-gate/config.json`:
-
-```json
-{
-  "apiKey": "your_key_here"
-}
-```
-
-To reset, delete the file and run `npx poke-gate` again.
+Only run Poke Gate on machines and networks you trust.
 
 ## Project structure
 
 ```
+clients/
+  Poke macOS Gate/       macOS menu bar app (SwiftUI)
 bin/
-  poke-gate.js       Entry point, onboarding
+  poke-gate.js           CLI entry point + onboarding
 src/
-  app.js             Startup: MCP server + tunnel
-  mcp-server.js      JSON-RPC MCP handler with OS tools
-  tunnel.js          PokeTunnel wrapper
+  app.js                 Startup: MCP server + tunnel
+  mcp-server.js          JSON-RPC MCP handler with OS tools
+  tunnel.js              PokeTunnel wrapper
 ```
 
 ## Credits

package/build.sh

@@ -0,0 +1,52 @@
+#!/bin/bash
+set -euo pipefail
+
+APP_NAME="Poke macOS Gate"
+SCHEME="Poke macOS Gate"
+PROJECT="clients/Poke macOS Gate/Poke macOS Gate.xcodeproj"
+BUILD_DIR="build"
+RELEASE_DIR="${BUILD_DIR}/release"
+ARM64_DIR="${BUILD_DIR}/arm64"
+X86_DIR="${BUILD_DIR}/x86_64"
+UNIVERSAL_APP="${RELEASE_DIR}/${APP_NAME}.app"
+DMG_NAME="Poke.macOS.Gate.dmg"
+DMG_PATH="${RELEASE_DIR}/${DMG_NAME}"
+
+rm -rf "$BUILD_DIR"
+mkdir -p "$RELEASE_DIR"
+
+echo "Building arm64..."
+xcodebuild -project "$PROJECT" -scheme "$SCHEME" -configuration Release \
+  -arch arm64 -derivedDataPath "$ARM64_DIR" \
+  CODE_SIGN_IDENTITY="-" CODE_SIGNING_REQUIRED=NO \
+  DEVELOPMENT_TEAM="" \
+  clean build 2>&1 | tail -5
+
+echo "Building x86_64..."
+xcodebuild -project "$PROJECT" -scheme "$SCHEME" -configuration Release \
+  -arch x86_64 -derivedDataPath "$X86_DIR" \
+  CODE_SIGN_IDENTITY="-" CODE_SIGNING_REQUIRED=NO \
+  DEVELOPMENT_TEAM="" \
+  clean build 2>&1 | tail -5
+
+ARM64_APP=$(find "$ARM64_DIR" -name "${APP_NAME}.app" -type d | head -1)
+X86_APP=$(find "$X86_DIR" -name "${APP_NAME}.app" -type d | head -1)
+
+echo "Creating universal binary..."
+cp -R "$ARM64_APP" "$UNIVERSAL_APP"
+
+find "$ARM64_APP" -type f -perm +111 | while read arm_bin; do
+  rel_path="${arm_bin#$ARM64_APP/}"
+  x86_bin="${X86_APP}/${rel_path}"
+  uni_bin="${UNIVERSAL_APP}/${rel_path}"
+
+  if [ -f "$x86_bin" ] && file "$arm_bin" | grep -q "Mach-O"; then
+    lipo -create "$arm_bin" "$x86_bin" -output "$uni_bin" 2>/dev/null || true
+  fi
+done
+
+echo "Creating DMG..."
+hdiutil create -volname "$APP_NAME" -srcfolder "$UNIVERSAL_APP" \
+  -ov -format UDZO "$DMG_PATH"
+
+echo "Done: $DMG_PATH"

package/clients/Poke macOS Gate/Poke macOS Gate/Assets.xcassets/AppIcon.appiconset/Contents.json

@@ -1,51 +1,61 @@
 {
   "images" : [
     {
+      "filename" : "icon_16x16.png",
       "idiom" : "mac",
       "scale" : "1x",
       "size" : "16x16"
     },
     {
+      "filename" : "icon_16x16@2x.png",
       "idiom" : "mac",
       "scale" : "2x",
       "size" : "16x16"
     },
     {
+      "filename" : "icon_32x32.png",
       "idiom" : "mac",
       "scale" : "1x",
       "size" : "32x32"
     },
     {
+      "filename" : "icon_32x32@2x.png",
       "idiom" : "mac",
       "scale" : "2x",
       "size" : "32x32"
     },
     {
+      "filename" : "icon_128x128.png",
       "idiom" : "mac",
       "scale" : "1x",
       "size" : "128x128"
     },
     {
+      "filename" : "icon_128x128@2x.png",
       "idiom" : "mac",
       "scale" : "2x",
       "size" : "128x128"
     },
     {
+      "filename" : "icon_256x256.png",
       "idiom" : "mac",
       "scale" : "1x",
       "size" : "256x256"
     },
     {
+      "filename" : "icon_256x256@2x.png",
       "idiom" : "mac",
       "scale" : "2x",
       "size" : "256x256"
     },
     {
+      "filename" : "icon_512x512.png",
       "idiom" : "mac",
       "scale" : "1x",
       "size" : "512x512"
     },
     {
+      "filename" : "icon_512x512@2x.png",
       "idiom" : "mac",
       "scale" : "2x",
       "size" : "512x512"

package/clients/Poke macOS Gate/Poke macOS Gate/GateService.swift

@@ -58,9 +58,28 @@ class GateService: ObservableObject {
             return
         }
         shouldRestart = true
+        fetchUserName()
         launchProcess()
     }
 
+    private func fetchUserName() {
+        guard let key = loadAPIKey() else { return }
+        Task {
+            let url = URL(string: "https://poke.com/api/v1/user/profile")!
+            var request = URLRequest(url: url)
+            request.setValue("Bearer \(key)", forHTTPHeaderField: "Authorization")
+            do {
+                let (data, response) = try await URLSession.shared.data(for: request)
+                guard let httpResp = response as? HTTPURLResponse, httpResp.statusCode == 200 else { return }
+                if let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any],
+                   let fullName = json["name"] as? String ?? json["email"] as? String {
+                    let firstName = fullName.components(separatedBy: CharacterSet.whitespaces.union(CharacterSet(charactersIn: "@"))).first ?? fullName
+                    self.userName = firstName
+                }
+            } catch {}
+        }
+    }
+
     func stop() {
         shouldRestart = false
         killProcess()

package/clients/Poke macOS Gate/Poke macOS Gate/Poke_macOS_GateApp.swift

@@ -38,9 +38,26 @@ struct MenuBarContent: View {
     @Environment(\.openWindow) private var openWindow
 
     var body: some View {
-        Label(service.status.rawValue, systemImage: statusIcon)
+        Label(statusText, systemImage: statusIcon)
             .foregroundStyle(statusColor)
 
+        if service.status == .connected {
+            Text("This machine is now accessible via Poke.")
+                .font(.caption2)
+                .foregroundStyle(.secondary)
+            Text("Ask your Poke to run commands or read files.")
+                .font(.caption2)
+                .foregroundStyle(.secondary)
+        } else if service.status == .starting {
+            Text("Establishing connection…")
+                .font(.caption2)
+                .foregroundStyle(.secondary)
+        } else if service.status == .error {
+            Text("Check Settings or view Logs for details.")
+                .font(.caption2)
+                .foregroundStyle(.secondary)
+        }
+
         Divider()
 
         Button("View Logs…") {
@@ -89,6 +106,20 @@ struct MenuBarContent: View {
         .font(.caption)
     }
 
+    private var statusText: String {
+        switch service.status {
+        case .connected:
+            if let name = service.userName {
+                return "Connected to your Poke, \(name)"
+            }
+            return "Connected to your Poke"
+        case .starting: return "Connecting…"
+        case .disconnected: return "Reconnecting…"
+        case .error: return "Connection error"
+        case .stopped: return "Stopped"
+        }
+    }
+
     private var statusIcon: String {
         switch service.status {
         case .connected: "circle.fill"

package/clients/Poke macOS Gate/Poke macOS Gate.xcodeproj/project.pbxproj

@@ -264,7 +264,7 @@
 					"$(inherited)",
 					"@executable_path/../Frameworks",
 				);
-				MARKETING_VERSION = 1.0;
+				MARKETING_VERSION = 0.0.4;
 				PRODUCT_BUNDLE_IDENTIFIER = "dev.fka.Poke-macOS-Gate";
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				REGISTER_APP_GROUPS = YES;
@@ -296,7 +296,7 @@
 					"$(inherited)",
 					"@executable_path/../Frameworks",
 				);
-				MARKETING_VERSION = 1.0;
+				MARKETING_VERSION = 0.0.4;
 				PRODUCT_BUNDLE_IDENTIFIER = "dev.fka.Poke-macOS-Gate";
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				REGISTER_APP_GROUPS = YES;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poke-gate",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Expose your machine to your Poke AI assistant via MCP tunnel",
   "type": "module",
   "bin": {