poke-gate 0.0.1 → 0.0.3

package/README.md

@@ -1,4 +1,4 @@
-# poke-gate
+# 🚪 poke-gate
 
 Expose your machine to your [Poke](https://poke.com) AI assistant via MCP tunnel.
 

package/clients/Poke macOS Gate/Poke macOS Gate/Assets.xcassets/AccentColor.colorset/Contents.json

@@ -0,0 +1,11 @@
+{
+  "colors" : [
+    {
+      "idiom" : "universal"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

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

@@ -0,0 +1,58 @@
+{
+  "images" : [
+    {
+      "idiom" : "mac",
+      "scale" : "1x",
+      "size" : "16x16"
+    },
+    {
+      "idiom" : "mac",
+      "scale" : "2x",
+      "size" : "16x16"
+    },
+    {
+      "idiom" : "mac",
+      "scale" : "1x",
+      "size" : "32x32"
+    },
+    {
+      "idiom" : "mac",
+      "scale" : "2x",
+      "size" : "32x32"
+    },
+    {
+      "idiom" : "mac",
+      "scale" : "1x",
+      "size" : "128x128"
+    },
+    {
+      "idiom" : "mac",
+      "scale" : "2x",
+      "size" : "128x128"
+    },
+    {
+      "idiom" : "mac",
+      "scale" : "1x",
+      "size" : "256x256"
+    },
+    {
+      "idiom" : "mac",
+      "scale" : "2x",
+      "size" : "256x256"
+    },
+    {
+      "idiom" : "mac",
+      "scale" : "1x",
+      "size" : "512x512"
+    },
+    {
+      "idiom" : "mac",
+      "scale" : "2x",
+      "size" : "512x512"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

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

@@ -0,0 +1,6 @@
+{
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

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

@@ -0,0 +1,8 @@
+// Unused — app runs as menu bar only
+import SwiftUI
+
+struct ContentView: View {
+    var body: some View {
+        EmptyView()
+    }
+}

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

@@ -0,0 +1,222 @@
+import Foundation
+import Combine
+import ScreenCaptureKit
+
+@MainActor
+class GateService: ObservableObject {
+    enum Status: String {
+        case stopped = "Stopped"
+        case starting = "Starting…"
+        case connected = "Connected"
+        case disconnected = "Disconnected"
+        case error = "Error"
+    }
+
+    @Published var status: Status = .stopped
+    @Published var logs: [String] = []
+    @Published var userName: String? = nil
+
+    private var hasAutoStarted = false
+    private var process: Process?
+    private var outputPipe: Pipe?
+    private var shouldRestart = true
+    private let maxLogs = 200
+
+    var apiKey: String {
+        get { loadAPIKey() ?? "" }
+        set { saveAPIKey(newValue) }
+    }
+
+    var hasAPIKey: Bool {
+        let key = loadAPIKey()
+        return key != nil && !key!.isEmpty
+    }
+
+    func autoStartIfNeeded() {
+        guard !hasAutoStarted else { return }
+        hasAutoStarted = true
+        requestScreenCapturePermission()
+        if hasAPIKey {
+            start()
+        }
+    }
+
+    private func requestScreenCapturePermission() {
+        Task {
+            do {
+                _ = try await SCShareableContent.current
+            } catch {
+                appendLog("Screen capture permission not granted yet.")
+            }
+        }
+    }
+
+    func start() {
+        guard hasAPIKey else {
+            status = .error
+            appendLog("No API key configured.")
+            return
+        }
+        shouldRestart = true
+        launchProcess()
+    }
+
+    func stop() {
+        shouldRestart = false
+        killProcess()
+        status = .stopped
+    }
+
+    func restart() {
+        stop()
+        DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) {
+            self.start()
+        }
+    }
+
+    private func shellPath() -> String {
+        let loginShell = ProcessInfo.processInfo.environment["SHELL"] ?? "/bin/zsh"
+        let pathProc = Process()
+        let pathPipe = Pipe()
+        pathProc.executableURL = URL(fileURLWithPath: loginShell)
+        pathProc.arguments = ["-ilc", "echo $PATH"]
+        pathProc.standardOutput = pathPipe
+        pathProc.standardError = FileHandle.nullDevice
+        pathProc.environment = ["HOME": NSHomeDirectory()]
+        try? pathProc.run()
+        pathProc.waitUntilExit()
+        let data = pathPipe.fileHandleForReading.readDataToEndOfFile()
+        return String(data: data, encoding: .utf8)?.trimmingCharacters(in: .whitespacesAndNewlines) ?? "/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"
+    }
+
+    private func launchProcess() {
+        killProcess()
+
+        status = .starting
+        appendLog("Starting poke-gate…")
+
+        let fullPath = shellPath()
+
+        let proc = Process()
+        let pipe = Pipe()
+
+        proc.executableURL = URL(fileURLWithPath: "/bin/zsh")
+        proc.arguments = ["-c", "npx -y poke-gate --verbose"]
+        proc.environment = ProcessInfo.processInfo.environment.merging(
+            [
+                "POKE_API_KEY": loadAPIKey() ?? "",
+                "PATH": fullPath,
+            ],
+            uniquingKeysWith: { _, new in new }
+        )
+        proc.standardOutput = pipe
+        proc.standardError = pipe
+        proc.currentDirectoryURL = FileManager.default.homeDirectoryForCurrentUser
+
+        let handle = pipe.fileHandleForReading
+        handle.readabilityHandler = { [weak self] fh in
+            let data = fh.availableData
+            guard !data.isEmpty, let line = String(data: data, encoding: .utf8) else { return }
+            DispatchQueue.main.async {
+                self?.handleOutput(line)
+            }
+        }
+
+        proc.terminationHandler = { [weak self] proc in
+            DispatchQueue.main.async {
+                self?.handleTermination(exitCode: proc.terminationStatus)
+            }
+        }
+
+        do {
+            try proc.run()
+            self.process = proc
+            self.outputPipe = pipe
+        } catch {
+            status = .error
+            appendLog("Failed to start: \(error.localizedDescription)")
+        }
+    }
+
+    private func killProcess() {
+        if let proc = process, proc.isRunning {
+            proc.terminate()
+        }
+        outputPipe?.fileHandleForReading.readabilityHandler = nil
+        process = nil
+        outputPipe = nil
+    }
+
+    private func handleOutput(_ raw: String) {
+        for line in raw.components(separatedBy: .newlines) where !line.isEmpty {
+            appendLog(line)
+
+            if line.contains("Tunnel connected") || line.contains("Ready") {
+                status = .connected
+            } else if line.contains("Tunnel disconnected") || line.contains("Reconnecting") {
+                status = .disconnected
+            } else if line.contains("Failed to connect") || line.contains("error") {
+                if status != .connected {
+                    status = .error
+                }
+            }
+        }
+    }
+
+    private func handleTermination(exitCode: Int32) {
+        appendLog("Process exited with code \(exitCode)")
+        if shouldRestart {
+            status = .disconnected
+            appendLog("Restarting in 2 seconds…")
+            DispatchQueue.main.asyncAfter(deadline: .now() + 2) {
+                if self.shouldRestart {
+                    self.launchProcess()
+                }
+            }
+        } else {
+            status = .stopped
+        }
+    }
+
+    private func appendLog(_ line: String) {
+        let ts = DateFormatter.localizedString(from: Date(), dateStyle: .none, timeStyle: .medium)
+        logs.append("[\(ts)] \(line)")
+        if logs.count > maxLogs {
+            logs.removeFirst(logs.count - maxLogs)
+        }
+    }
+
+    // MARK: - Config
+
+    private var configURL: URL {
+        let configDir: URL
+        if let xdg = ProcessInfo.processInfo.environment["XDG_CONFIG_HOME"] {
+            configDir = URL(fileURLWithPath: xdg)
+        } else {
+            configDir = FileManager.default.homeDirectoryForCurrentUser
+                .appendingPathComponent(".config")
+        }
+        return configDir
+            .appendingPathComponent("poke-gate")
+            .appendingPathComponent("config.json")
+    }
+
+    private func loadAPIKey() -> String? {
+        guard let data = try? Data(contentsOf: configURL),
+              let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any],
+              let key = json["apiKey"] as? String else {
+            return nil
+        }
+        return key
+    }
+
+    private func saveAPIKey(_ key: String) {
+        let dir = configURL.deletingLastPathComponent()
+        try? FileManager.default.createDirectory(at: dir, withIntermediateDirectories: true)
+        let json: [String: Any] = ["apiKey": key]
+        if let data = try? JSONSerialization.data(withJSONObject: json, options: [.prettyPrinted]) {
+            try? data.write(to: configURL)
+        }
+        objectWillChange.send()
+    }
+}

package/clients/Poke macOS Gate/Poke macOS Gate/Info.plist

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>LSUIElement</key>
+	<true/>
+</dict>
+</plist>

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

@@ -0,0 +1,2 @@
+// Unused — kept for Xcode project reference compatibility
+import Foundation

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

@@ -0,0 +1,47 @@
+import SwiftUI
+
+struct LogsView: View {
+    @ObservedObject var service: GateService
+
+    var body: some View {
+        VStack(spacing: 0) {
+            HStack {
+                Text("Logs")
+                    .font(.headline)
+                Spacer()
+                Button("Clear") {
+                    service.logs.removeAll()
+                }
+                .buttonStyle(.plain)
+                .foregroundStyle(.secondary)
+                .font(.caption)
+            }
+            .padding(.horizontal, 12)
+            .padding(.vertical, 8)
+
+            Divider()
+
+            ScrollViewReader { proxy in
+                ScrollView {
+                    LazyVStack(alignment: .leading, spacing: 2) {
+                        ForEach(Array(service.logs.enumerated()), id: \.offset) { index, line in
+                            Text(line)
+                                .font(.system(.caption, design: .monospaced))
+                                .foregroundStyle(.primary)
+                                .textSelection(.enabled)
+                                .id(index)
+                        }
+                    }
+                    .padding(.horizontal, 12)
+                    .padding(.vertical, 8)
+                }
+                .onChange(of: service.logs.count) { _, _ in
+                    if let last = service.logs.indices.last {
+                        proxy.scrollTo(last, anchor: .bottom)
+                    }
+                }
+            }
+        }
+        .frame(width: 480, height: 320)
+    }
+}

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

@@ -0,0 +1,109 @@
+import SwiftUI
+
+@main
+struct Poke_macOS_GateApp: App {
+    @StateObject private var service = GateService()
+
+    var body: some Scene {
+        MenuBarExtra {
+            MenuBarContent(service: service)
+                .onAppear { service.autoStartIfNeeded() }
+        } label: {
+            Image(systemName: menuBarIcon)
+        }
+
+        Window("Logs", id: "logs") {
+            LogsView(service: service)
+        }
+        .defaultSize(width: 480, height: 320)
+
+        Window("Settings", id: "settings") {
+            SettingsView(service: service)
+        }
+        .windowResizability(.contentSize)
+    }
+
+    private var menuBarIcon: String {
+        switch service.status {
+        case .connected: "door.left.hand.open"
+        case .starting, .disconnected: "door.left.hand.closed"
+        case .error: "exclamationmark.triangle"
+        case .stopped: "door.left.hand.closed"
+        }
+    }
+}
+
+struct MenuBarContent: View {
+    @ObservedObject var service: GateService
+    @Environment(\.openWindow) private var openWindow
+
+    var body: some View {
+        Label(service.status.rawValue, systemImage: statusIcon)
+            .foregroundStyle(statusColor)
+
+        Divider()
+
+        Button("View Logs…") {
+            NSApp.activate(ignoringOtherApps: true)
+            openWindow(id: "logs")
+        }
+
+        Button("Settings…") {
+            NSApp.activate(ignoringOtherApps: true)
+            openWindow(id: "settings")
+        }
+
+        Divider()
+
+        if service.status == .connected || service.status == .starting || service.status == .disconnected {
+            Button("Restart") {
+                service.restart()
+            }
+        } else {
+            Button("Start") {
+                service.start()
+            }
+        }
+
+        Divider()
+
+        Button("Quit Poke Gate") {
+            service.stop()
+            DispatchQueue.main.asyncAfter(deadline: .now() + 0.3) {
+                NSApp.terminate(nil)
+            }
+        }
+        .keyboardShortcut("q")
+
+        Divider()
+
+        Text("Poke Gate v0.0.3")
+            .font(.caption)
+            .foregroundStyle(.secondary)
+        Text("Community project — not affiliated with Poke")
+            .font(.caption2)
+            .foregroundStyle(.secondary)
+        Button("GitHub") {
+            NSWorkspace.shared.open(URL(string: "https://github.com/f/poke-gate")!)
+        }
+        .font(.caption)
+    }
+
+    private var statusIcon: String {
+        switch service.status {
+        case .connected: "circle.fill"
+        case .starting, .disconnected: "circle.dotted"
+        case .error: "exclamationmark.circle.fill"
+        case .stopped: "circle"
+        }
+    }
+
+    private var statusColor: Color {
+        switch service.status {
+        case .connected: .green
+        case .starting, .disconnected: .yellow
+        case .error: .red
+        case .stopped: .secondary
+        }
+    }
+}

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

@@ -0,0 +1,50 @@
+import SwiftUI
+
+struct SettingsView: View {
+    @ObservedObject var service: GateService
+    @State private var apiKeyInput: String = ""
+    @Environment(\.dismiss) private var dismiss
+
+    var body: some View {
+        VStack(spacing: 16) {
+            Text("Poke Gate Settings")
+                .font(.headline)
+
+            VStack(alignment: .leading, spacing: 8) {
+                Text("API Key")
+                    .font(.subheadline)
+                    .foregroundStyle(.secondary)
+
+                SecureField("Paste your API key", text: $apiKeyInput)
+                    .textFieldStyle(.roundedBorder)
+
+                Link("Get your key at poke.com/kitchen/api-keys",
+                     destination: URL(string: "https://poke.com/kitchen/api-keys")!)
+                    .font(.caption)
+                    .foregroundStyle(.blue)
+            }
+
+            HStack {
+                Button("Cancel") {
+                    dismiss()
+                }
+                .keyboardShortcut(.cancelAction)
+
+                Spacer()
+
+                Button("Save") {
+                    service.apiKey = apiKeyInput
+                    dismiss()
+                    service.restart()
+                }
+                .keyboardShortcut(.defaultAction)
+                .disabled(apiKeyInput.isEmpty)
+            }
+        }
+        .padding(20)
+        .frame(width: 360)
+        .onAppear {
+            apiKeyInput = service.apiKey
+        }
+    }
+}

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

@@ -0,0 +1,336 @@
+// !$*UTF8*$!
+{
+	archiveVersion = 1;
+	classes = {
+	};
+	objectVersion = 77;
+	objects = {
+
+/* Begin PBXFileReference section */
+		442DE4462F71DCD9009BF9EF /* Poke macOS Gate.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = "Poke macOS Gate.app"; sourceTree = BUILT_PRODUCTS_DIR; };
+/* End PBXFileReference section */
+
+/* Begin PBXFileSystemSynchronizedRootGroup section */
+		442DE4482F71DCD9009BF9EF /* Poke macOS Gate */ = {
+			isa = PBXFileSystemSynchronizedRootGroup;
+			path = "Poke macOS Gate";
+			sourceTree = "<group>";
+		};
+/* End PBXFileSystemSynchronizedRootGroup section */
+
+/* Begin PBXFrameworksBuildPhase section */
+		442DE4432F71DCD9009BF9EF /* Frameworks */ = {
+			isa = PBXFrameworksBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXFrameworksBuildPhase section */
+
+/* Begin PBXGroup section */
+		442DE43D2F71DCD9009BF9EF = {
+			isa = PBXGroup;
+			children = (
+				442DE4482F71DCD9009BF9EF /* Poke macOS Gate */,
+				442DE4472F71DCD9009BF9EF /* Products */,
+			);
+			sourceTree = "<group>";
+		};
+		442DE4472F71DCD9009BF9EF /* Products */ = {
+			isa = PBXGroup;
+			children = (
+				442DE4462F71DCD9009BF9EF /* Poke macOS Gate.app */,
+			);
+			name = Products;
+			sourceTree = "<group>";
+		};
+/* End PBXGroup section */
+
+/* Begin PBXNativeTarget section */
+		442DE4452F71DCD9009BF9EF /* Poke macOS Gate */ = {
+			isa = PBXNativeTarget;
+			buildConfigurationList = 442DE4532F71DCDA009BF9EF /* Build configuration list for PBXNativeTarget "Poke macOS Gate" */;
+			buildPhases = (
+				442DE4422F71DCD9009BF9EF /* Sources */,
+				442DE4432F71DCD9009BF9EF /* Frameworks */,
+				442DE4442F71DCD9009BF9EF /* Resources */,
+			);
+			buildRules = (
+			);
+			dependencies = (
+			);
+			fileSystemSynchronizedGroups = (
+				442DE4482F71DCD9009BF9EF /* Poke macOS Gate */,
+			);
+			name = "Poke macOS Gate";
+			packageProductDependencies = (
+			);
+			productName = "Poke macOS Gate";
+			productReference = 442DE4462F71DCD9009BF9EF /* Poke macOS Gate.app */;
+			productType = "com.apple.product-type.application";
+		};
+/* End PBXNativeTarget section */
+
+/* Begin PBXProject section */
+		442DE43E2F71DCD9009BF9EF /* Project object */ = {
+			isa = PBXProject;
+			attributes = {
+				BuildIndependentTargetsInParallel = 1;
+				LastSwiftUpdateCheck = 2620;
+				LastUpgradeCheck = 2620;
+				TargetAttributes = {
+					442DE4452F71DCD9009BF9EF = {
+						CreatedOnToolsVersion = 26.2;
+					};
+				};
+			};
+			buildConfigurationList = 442DE4412F71DCD9009BF9EF /* Build configuration list for PBXProject "Poke macOS Gate" */;
+			developmentRegion = en;
+			hasScannedForEncodings = 0;
+			knownRegions = (
+				en,
+				Base,
+			);
+			mainGroup = 442DE43D2F71DCD9009BF9EF;
+			minimizedProjectReferenceProxies = 1;
+			preferredProjectObjectVersion = 77;
+			productRefGroup = 442DE4472F71DCD9009BF9EF /* Products */;
+			projectDirPath = "";
+			projectRoot = "";
+			targets = (
+				442DE4452F71DCD9009BF9EF /* Poke macOS Gate */,
+			);
+		};
+/* End PBXProject section */
+
+/* Begin PBXResourcesBuildPhase section */
+		442DE4442F71DCD9009BF9EF /* Resources */ = {
+			isa = PBXResourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXResourcesBuildPhase section */
+
+/* Begin PBXSourcesBuildPhase section */
+		442DE4422F71DCD9009BF9EF /* Sources */ = {
+			isa = PBXSourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXSourcesBuildPhase section */
+
+/* Begin XCBuildConfiguration section */
+		442DE4512F71DCDA009BF9EF /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++20";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_ENABLE_OBJC_WEAK = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = YES;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = dwarf;
+				DEVELOPMENT_TEAM = RJA7656U34;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_TESTABILITY = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = YES;
+				GCC_C_LANGUAGE_STANDARD = gnu17;
+				GCC_DYNAMIC_NO_PIC = NO;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_OPTIMIZATION_LEVEL = 0;
+				GCC_PREPROCESSOR_DEFINITIONS = (
+					"DEBUG=1",
+					"$(inherited)",
+				);
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				LOCALIZATION_PREFERS_STRING_CATALOGS = YES;
+				MACOSX_DEPLOYMENT_TARGET = 26.2;
+				MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
+				MTL_FAST_MATH = YES;
+				ONLY_ACTIVE_ARCH = YES;
+				SDKROOT = macosx;
+				SWIFT_ACTIVE_COMPILATION_CONDITIONS = "DEBUG $(inherited)";
+				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+			};
+			name = Debug;
+		};
+		442DE4522F71DCDA009BF9EF /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++20";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_ENABLE_OBJC_WEAK = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = YES;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				DEVELOPMENT_TEAM = RJA7656U34;
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = YES;
+				GCC_C_LANGUAGE_STANDARD = gnu17;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				LOCALIZATION_PREFERS_STRING_CATALOGS = YES;
+				MACOSX_DEPLOYMENT_TARGET = 26.2;
+				MTL_ENABLE_DEBUG_INFO = NO;
+				MTL_FAST_MATH = YES;
+				SDKROOT = macosx;
+				SWIFT_COMPILATION_MODE = wholemodule;
+			};
+			name = Release;
+		};
+		442DE4542F71DCDA009BF9EF /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
+				CODE_SIGN_STYLE = Automatic;
+				COMBINE_HIDPI_IMAGES = YES;
+				CURRENT_PROJECT_VERSION = 1;
+				DEVELOPMENT_TEAM = RJA7656U34;
+				ENABLE_APP_SANDBOX = NO;
+				ENABLE_HARDENED_RUNTIME = NO;
+				ENABLE_PREVIEWS = YES;
+				GENERATE_INFOPLIST_FILE = YES;
+				INFOPLIST_FILE = "Poke macOS Gate/Info.plist";
+				INFOPLIST_KEY_NSHumanReadableCopyright = "";
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/../Frameworks",
+				);
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = "dev.fka.Poke-macOS-Gate";
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				REGISTER_APP_GROUPS = YES;
+				STRING_CATALOG_GENERATE_SYMBOLS = YES;
+				SWIFT_APPROACHABLE_CONCURRENCY = YES;
+				SWIFT_DEFAULT_ACTOR_ISOLATION = MainActor;
+				SWIFT_EMIT_LOC_STRINGS = YES;
+				SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
+				SWIFT_VERSION = 5.0;
+			};
+			name = Debug;
+		};
+		442DE4552F71DCDA009BF9EF /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
+				CODE_SIGN_STYLE = Automatic;
+				COMBINE_HIDPI_IMAGES = YES;
+				CURRENT_PROJECT_VERSION = 1;
+				DEVELOPMENT_TEAM = RJA7656U34;
+				ENABLE_APP_SANDBOX = NO;
+				ENABLE_HARDENED_RUNTIME = NO;
+				ENABLE_PREVIEWS = YES;
+				GENERATE_INFOPLIST_FILE = YES;
+				INFOPLIST_FILE = "Poke macOS Gate/Info.plist";
+				INFOPLIST_KEY_NSHumanReadableCopyright = "";
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/../Frameworks",
+				);
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = "dev.fka.Poke-macOS-Gate";
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				REGISTER_APP_GROUPS = YES;
+				STRING_CATALOG_GENERATE_SYMBOLS = YES;
+				SWIFT_APPROACHABLE_CONCURRENCY = YES;
+				SWIFT_DEFAULT_ACTOR_ISOLATION = MainActor;
+				SWIFT_EMIT_LOC_STRINGS = YES;
+				SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
+				SWIFT_VERSION = 5.0;
+			};
+			name = Release;
+		};
+/* End XCBuildConfiguration section */
+
+/* Begin XCConfigurationList section */
+		442DE4412F71DCD9009BF9EF /* Build configuration list for PBXProject "Poke macOS Gate" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				442DE4512F71DCDA009BF9EF /* Debug */,
+				442DE4522F71DCDA009BF9EF /* Release */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+		442DE4532F71DCDA009BF9EF /* Build configuration list for PBXNativeTarget "Poke macOS Gate" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				442DE4542F71DCDA009BF9EF /* Debug */,
+				442DE4552F71DCDA009BF9EF /* Release */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+/* End XCConfigurationList section */
+	};
+	rootObject = 442DE43E2F71DCD9009BF9EF /* Project object */;
+}

package/clients/Poke macOS Gate/Poke macOS Gate.xcodeproj/project.xcworkspace/contents.xcworkspacedata

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Workspace
+   version = "1.0">
+   <FileRef
+      location = "self:">
+   </FileRef>
+</Workspace>

package/clients/Poke macOS Gate/Poke macOS Gate.xcodeproj/xcuserdata/fka.xcuserdatad/xcschemes/xcschememanagement.plist

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>SchemeUserState</key>
+	<dict>
+		<key>Poke macOS Gate.xcscheme_^#shared#^_</key>
+		<dict>
+			<key>orderHint</key>
+			<integer>0</integer>
+		</dict>
+	</dict>
+</dict>
+</plist>

package/package.json

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

package/src/app.js

@@ -1,9 +1,12 @@
-import { startMcpServer } from "./mcp-server.js";
+import { startMcpServer, enableLogging } from "./mcp-server.js";
 import { startTunnel } from "./tunnel.js";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
 import { homedir } from "node:os";
 
+const verbose = process.argv.includes("--verbose") || process.argv.includes("-v");
+enableLogging(verbose);
+
 function resolveToken() {
   if (process.env.POKE_API_KEY) return process.env.POKE_API_KEY;
 

package/src/mcp-server.js

@@ -2,12 +2,29 @@ import http from "node:http";
 import { execSync, exec } from "node:child_process";
 import { readFileSync, writeFileSync, readdirSync, statSync } from "node:fs";
 import { hostname, platform, arch, uptime, totalmem, freemem, homedir } from "node:os";
-import { join, resolve } from "node:path";
+import { join, resolve, extname } from "node:path";
 
 const SERVER_INFO = { name: "poke-gate", version: "0.0.1" };
 
 const COMMAND_TIMEOUT = 30_000;
 
+let logEnabled = false;
+
+export function enableLogging(enabled) {
+  logEnabled = enabled;
+}
+
+function logTool(name, args, result) {
+  if (!logEnabled) return;
+  const ts = new Date().toISOString().slice(11, 19);
+  console.log(`[${ts}] tool: ${name}`);
+  if (name === "run_command") console.log(`[${ts}]   $ ${args.command}${args.cwd ? ` (in ${args.cwd})` : ""}`);
+  else if (name === "read_file") console.log(`[${ts}]   read: ${args.path}`);
+  else if (name === "write_file") console.log(`[${ts}]   write: ${args.path}`);
+  else if (name === "list_directory") console.log(`[${ts}]   ls: ${args.path || "~"}`);
+  if (result?.isError) console.log(`[${ts}]   error`);
+}
+
 const TOOLS = [
   {
     name: "run_command",
@@ -62,6 +79,30 @@ const TOOLS = [
     description: "Get system information: OS, hostname, architecture, uptime, memory, and home directory.",
     inputSchema: { type: "object", properties: {} },
   },
+  {
+    name: "read_image",
+    description:
+      "Read an image or binary file and return it as base64-encoded data. " +
+      "Supports png, jpg, jpeg, gif, webp, pdf, and any other binary file. " +
+      "Returns the base64 string and MIME type.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Absolute or relative path to the image/binary file" },
+      },
+      required: ["path"],
+    },
+  },
+  {
+    name: "take_screenshot",
+    description: "Take a screenshot of the user's screen and save it to a file. Returns the file path. Requires screen recording permission on macOS.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "File path to save the screenshot (optional, defaults to ~/Desktop/screenshot-<timestamp>.png)" },
+      },
+    },
+  },
 ];
 
 function runCommand(command, cwd) {
@@ -85,18 +126,26 @@ function runCommand(command, cwd) {
 function handleToolCall(name, args) {
   switch (name) {
     case "run_command": {
-      return runCommand(args.command, args.cwd).then((result) => ({
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-      }));
+      logTool(name, args);
+      return runCommand(args.command, args.cwd).then((result) => {
+        const r = { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        if (result.exitCode !== 0) r.isError = true;
+        logTool(name, args, r);
+        return r;
+      });
     }
 
     case "read_file": {
       try {
         const p = resolve(args.path.replace(/^~/, homedir()));
         const text = readFileSync(p, "utf-8");
-        return { content: [{ type: "text", text: text.slice(0, 100_000) }] };
+        const r = { content: [{ type: "text", text: text.slice(0, 100_000) }] };
+        logTool(name, args, r);
+        return r;
       } catch (err) {
-        return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+        const r = { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+        logTool(name, args, r);
+        return r;
       }
     }
 
@@ -104,26 +153,34 @@ function handleToolCall(name, args) {
       try {
         const p = resolve(args.path.replace(/^~/, homedir()));
         writeFileSync(p, args.content);
-        return { content: [{ type: "text", text: `Written to ${p}` }] };
+        const r = { content: [{ type: "text", text: `Written to ${p}` }] };
+        logTool(name, args, r);
+        return r;
       } catch (err) {
-        return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+        const r = { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+        logTool(name, args, r);
+        return r;
       }
     }
 
     case "list_directory": {
       try {
         const dir = resolve((args.path || "~").replace(/^~/, homedir()));
-        const entries = readdirSync(dir).map((name) => {
+        const entries = readdirSync(dir).map((entry) => {
           try {
-            const s = statSync(join(dir, name));
-            return `${s.isDirectory() ? "d" : "-"} ${name}`;
+            const s = statSync(join(dir, entry));
+            return `${s.isDirectory() ? "d" : "-"} ${entry}`;
           } catch {
-            return `? ${name}`;
+            return `? ${entry}`;
           }
         });
-        return { content: [{ type: "text", text: entries.join("\n") }] };
+        const r = { content: [{ type: "text", text: entries.join("\n") }] };
+        logTool(name, args, r);
+        return r;
       } catch (err) {
-        return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+        const r = { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+        logTool(name, args, r);
+        return r;
       }
     }
 
@@ -138,9 +195,58 @@ function handleToolCall(name, args) {
         homeDir: homedir(),
         nodeVersion: process.version,
       };
+      logTool(name, args);
       return { content: [{ type: "text", text: JSON.stringify(info, null, 2) }] };
     }
 
+    case "read_image": {
+      try {
+        const p = resolve(args.path.replace(/^~/, homedir()));
+        const ext = extname(p).toLowerCase().slice(1);
+        const mimeMap = {
+          png: "image/png", jpg: "image/jpeg", jpeg: "image/jpeg",
+          gif: "image/gif", webp: "image/webp", svg: "image/svg+xml",
+          pdf: "application/pdf", ico: "image/x-icon", bmp: "image/bmp",
+        };
+        const mimeType = mimeMap[ext] || "application/octet-stream";
+        const buf = readFileSync(p);
+        const base64 = buf.toString("base64");
+        logTool(name, args);
+
+        if (mimeType.startsWith("image/")) {
+          return {
+            content: [
+              { type: "image", data: base64, mimeType },
+              { type: "text", text: `Image: ${p} (${mimeType}, ${buf.length} bytes)` },
+            ],
+          };
+        }
+        return {
+          content: [
+            { type: "text", text: `File: ${p} (${mimeType}, ${buf.length} bytes)\nBase64: ${base64.slice(0, 200)}${base64.length > 200 ? "..." : ""}` },
+          ],
+        };
+      } catch (err) {
+        const r = { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+        logTool(name, args, r);
+        return r;
+      }
+    }
+
+    case "take_screenshot": {
+      const ts = new Date().toISOString().replace(/[:.]/g, "-");
+      const dest = args.path
+        ? resolve(args.path.replace(/^~/, homedir()))
+        : join(homedir(), "Desktop", `screenshot-${ts}.png`);
+      logTool(name, { path: dest });
+      return runCommand(`/usr/sbin/screencapture -x "${dest}"`, homedir()).then((result) => {
+        if (result.exitCode === 0) {
+          return { content: [{ type: "text", text: `Screenshot saved to ${dest}` }] };
+        }
+        return { content: [{ type: "text", text: `Screenshot failed: ${result.stderr || "unknown error"}` }], isError: true };
+      });
+    }
+
     default:
       return { content: [{ type: "text", text: `Unknown tool: ${name}` }], isError: true };
   }