@alivault/pico 0.13.0 → 0.14.0

package/.output/server/node_modules/node-pty/build/Makefile

@@ -353,8 +353,8 @@ ifeq ($(strip $(foreach prefix,$(NO_LOAD),\
 endif
 
 quiet_cmd_regen_makefile = ACTION Regenerating $@
-cmd_regen_makefile = cd $(srcdir); /home/runner/setup-pnpm/node_modules/.pnpm/pnpm@10.33.0/node_modules/pnpm/dist/node_modules/node-gyp/gyp/gyp_main.py -fmake --ignore-environment "-Dlibrary=shared_library" "-Dvisibility=default" "-Dnode_root_dir=/home/runner/.cache/node-gyp/22.22.3" "-Dnode_gyp_dir=/home/runner/setup-pnpm/node_modules/.pnpm/pnpm@10.33.0/node_modules/pnpm/dist/node_modules/node-gyp" "-Dnode_lib_file=/home/runner/.cache/node-gyp/22.22.3/<(target_arch)/node.lib" "-Dmodule_root_dir=/home/runner/work/pico/pico/node_modules/.pnpm/node-pty@1.1.0/node_modules/node-pty" "-Dnode_engine=v8" "--depth=." "-Goutput_dir=." "--generator-output=build" -I/home/runner/work/pico/pico/node_modules/.pnpm/node-pty@1.1.0/node_modules/node-pty/build/config.gypi -I/home/runner/setup-pnpm/node_modules/.pnpm/pnpm@10.33.0/node_modules/pnpm/dist/node_modules/node-gyp/addon.gypi -I/home/runner/.cache/node-gyp/22.22.3/include/node/common.gypi "--toplevel-dir=." binding.gyp
-Makefile: $(srcdir)/../../../../../../../../.cache/node-gyp/22.22.3/include/node/common.gypi $(srcdir)/../../../../../../../../setup-pnpm/node_modules/.pnpm/pnpm@10.33.0/node_modules/pnpm/dist/node_modules/node-gyp/addon.gypi $(srcdir)/../../../node-addon-api@7.1.1/node_modules/node-addon-api/except.gypi $(srcdir)/../../../node-addon-api@7.1.1/node_modules/node-addon-api/node_addon_api.gyp $(srcdir)/../../../node-addon-api@7.1.1/node_modules/node-addon-api/noexcept.gypi $(srcdir)/binding.gyp $(srcdir)/build/config.gypi
+cmd_regen_makefile = cd $(srcdir); /home/runner/setup-pnpm/node_modules/.pnpm/pnpm@10.33.0/node_modules/pnpm/dist/node_modules/node-gyp/gyp/gyp_main.py -fmake --ignore-environment "-Dlibrary=shared_library" "-Dvisibility=default" "-Dnode_root_dir=/home/runner/.cache/node-gyp/22.23.1" "-Dnode_gyp_dir=/home/runner/setup-pnpm/node_modules/.pnpm/pnpm@10.33.0/node_modules/pnpm/dist/node_modules/node-gyp" "-Dnode_lib_file=/home/runner/.cache/node-gyp/22.23.1/<(target_arch)/node.lib" "-Dmodule_root_dir=/home/runner/work/pico/pico/node_modules/.pnpm/node-pty@1.1.0/node_modules/node-pty" "-Dnode_engine=v8" "--depth=." "-Goutput_dir=." "--generator-output=build" -I/home/runner/work/pico/pico/node_modules/.pnpm/node-pty@1.1.0/node_modules/node-pty/build/config.gypi -I/home/runner/setup-pnpm/node_modules/.pnpm/pnpm@10.33.0/node_modules/pnpm/dist/node_modules/node-gyp/addon.gypi -I/home/runner/.cache/node-gyp/22.23.1/include/node/common.gypi "--toplevel-dir=." binding.gyp
+Makefile: $(srcdir)/../../../../../../../../.cache/node-gyp/22.23.1/include/node/common.gypi $(srcdir)/../../../../../../../../setup-pnpm/node_modules/.pnpm/pnpm@10.33.0/node_modules/pnpm/dist/node_modules/node-gyp/addon.gypi $(srcdir)/../../../node-addon-api@7.1.1/node_modules/node-addon-api/except.gypi $(srcdir)/../../../node-addon-api@7.1.1/node_modules/node-addon-api/node_addon_api.gyp $(srcdir)/../../../node-addon-api@7.1.1/node_modules/node-addon-api/noexcept.gypi $(srcdir)/binding.gyp $(srcdir)/build/config.gypi
 	$(call do_cmd,regen_makefile)
 
 # "all" is a concatenation of the "all" targets from all the included

package/.output/server/node_modules/node-pty/build/pty.target.mk

@@ -42,13 +42,13 @@ CFLAGS_CC_Debug := \
 	-std=gnu++17
 
 INCS_Debug := \
-	-I/home/runner/.cache/node-gyp/22.22.3/include/node \
-	-I/home/runner/.cache/node-gyp/22.22.3/src \
-	-I/home/runner/.cache/node-gyp/22.22.3/deps/openssl/config \
-	-I/home/runner/.cache/node-gyp/22.22.3/deps/openssl/openssl/include \
-	-I/home/runner/.cache/node-gyp/22.22.3/deps/uv/include \
-	-I/home/runner/.cache/node-gyp/22.22.3/deps/zlib \
-	-I/home/runner/.cache/node-gyp/22.22.3/deps/v8/include \
+	-I/home/runner/.cache/node-gyp/22.23.1/include/node \
+	-I/home/runner/.cache/node-gyp/22.23.1/src \
+	-I/home/runner/.cache/node-gyp/22.23.1/deps/openssl/config \
+	-I/home/runner/.cache/node-gyp/22.23.1/deps/openssl/openssl/include \
+	-I/home/runner/.cache/node-gyp/22.23.1/deps/uv/include \
+	-I/home/runner/.cache/node-gyp/22.23.1/deps/zlib \
+	-I/home/runner/.cache/node-gyp/22.23.1/deps/v8/include \
 	-I$(srcdir)/../../../node-addon-api@7.1.1/node_modules/node-addon-api
 
 DEFS_Release := \
@@ -89,13 +89,13 @@ CFLAGS_CC_Release := \
 	-std=gnu++17
 
 INCS_Release := \
-	-I/home/runner/.cache/node-gyp/22.22.3/include/node \
-	-I/home/runner/.cache/node-gyp/22.22.3/src \
-	-I/home/runner/.cache/node-gyp/22.22.3/deps/openssl/config \
-	-I/home/runner/.cache/node-gyp/22.22.3/deps/openssl/openssl/include \
-	-I/home/runner/.cache/node-gyp/22.22.3/deps/uv/include \
-	-I/home/runner/.cache/node-gyp/22.22.3/deps/zlib \
-	-I/home/runner/.cache/node-gyp/22.22.3/deps/v8/include \
+	-I/home/runner/.cache/node-gyp/22.23.1/include/node \
+	-I/home/runner/.cache/node-gyp/22.23.1/src \
+	-I/home/runner/.cache/node-gyp/22.23.1/deps/openssl/config \
+	-I/home/runner/.cache/node-gyp/22.23.1/deps/openssl/openssl/include \
+	-I/home/runner/.cache/node-gyp/22.23.1/deps/uv/include \
+	-I/home/runner/.cache/node-gyp/22.23.1/deps/zlib \
+	-I/home/runner/.cache/node-gyp/22.23.1/deps/v8/include \
 	-I$(srcdir)/../../../node-addon-api@7.1.1/node_modules/node-addon-api
 
 OBJS := \

package/README.md

@@ -1,16 +1,30 @@
 # Pico
 
-Pico is a local, keyboard-friendly browser workspace for Pi coding-agent sessions.
+Pico is a local, keyboard-friendly workspace for Pi coding-agent sessions, available in the browser and as a native SwiftUI app for macOS and iOS.
 
 It gives you a persistent session browser, a live conversation shell, git tools, and project-aware prompt helpers in one app.
 
+## Browser workspace
+
 ![Pico workspace showing the session browser, conversation shell, composer, and git tools](public/screenshots/pico-workspace.png)
 
 ![Pico workspace showing project-aware context and coding-agent workflow](public/screenshots/pico-workspace-alt.png)
 
-| Dark mobile                                                                  | Light mobile                                                                      |
-| ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
-| ![Pico mobile session view in dark mode](public/screenshots/pico-mobile.png) | ![Pico mobile session view in light mode](public/screenshots/pico-mobile-alt.png) |
+| Dark mobile browser                                                     | Light mobile browser                                                         |
+| ----------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
+| ![Pico mobile browser in dark mode](public/screenshots/pico-mobile.png) | ![Pico mobile browser in light mode](public/screenshots/pico-mobile-alt.png) |
+
+## Native Apple clients
+
+Pico also includes a shared SwiftUI client with platform-native layouts for macOS and iOS. Both clients connect to the same local Pico server, stream live session updates, manage conversations, and provide native Git and project-file workflows.
+
+| macOS dark                                                                       | macOS light                                                                        |
+| -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
+| ![Pico native macOS client in dark mode](public/screenshots/pico-macos-dark.jpg) | ![Pico native macOS client in light mode](public/screenshots/pico-macos-light.jpg) |
+
+| iOS dark                                                                     | iOS light                                                                      |
+| ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| ![Pico native iOS client in dark mode](public/screenshots/pico-ios-dark.png) | ![Pico native iOS client in light mode](public/screenshots/pico-ios-light.png) |
 
 ## What Pico gives you
 
@@ -27,7 +41,7 @@ It gives you a persistent session browser, a live conversation shell, git tools,
 
 ## Built on Pi
 
-Pico runs Pi locally through the bundled `@earendil-works/pi-coding-agent` SDK dependency, pinned to `0.74.0` for reproducible installs. You do not need a separate global Pi install for normal use.
+Pico runs Pi locally through the bundled `@earendil-works/pi-coding-agent` SDK dependency, pinned to `0.80.6` for reproducible installs. You do not need a separate global Pi install for normal use.
 
 If you intentionally want to test Pico against a different Pi SDK checkout or install, set:
 
@@ -43,7 +57,7 @@ pnpm update:pi
 
 ## Getting started
 
-Run Pico without cloning the repo:
+Run Pico without cloning the repo (Node.js 22.19.0 or newer is required):
 
 ```bash
 npx @alivault/pico
@@ -94,6 +108,53 @@ Then open:
 http://localhost:3141
 ```
 
+## Developing the native macOS and iOS app
+
+The native SwiftUI client lives in `apps/apple/Pico` and builds for both macOS and iOS. It connects to an already-running Pico server over HTTP JSON and SSE; it does not embed the Pi runtime. The native clients are currently built from source and are not distributed through the npm package.
+
+Open the shared project in Xcode:
+
+```bash
+open apps/apple/Pico/Pico.xcodeproj
+```
+
+Select the `Pico` scheme and a macOS, iPhone, or iPad destination.
+
+Build and launch the macOS app:
+
+```bash
+xcodebuild \
+  -project apps/apple/Pico/Pico.xcodeproj \
+  -scheme Pico \
+  -destination 'platform=macOS' \
+  -derivedDataPath /tmp/pico-macos-build \
+  build
+
+open /tmp/pico-macos-build/Build/Products/Debug/Pico.app
+```
+
+The macOS client defaults to `http://localhost:3141`. Keep Pico on a trusted local machine or network; the server does not currently provide remote pairing or token authentication.
+
+Run the shared native tests on macOS:
+
+```bash
+xcodebuild \
+  -project apps/apple/Pico/Pico.xcodeproj \
+  -scheme Pico \
+  -destination 'platform=macOS' \
+  test
+```
+
+Run the iOS tests with an installed simulator:
+
+```bash
+xcodebuild \
+  -project apps/apple/Pico/Pico.xcodeproj \
+  -scheme Pico \
+  -destination 'platform=iOS Simulator,name=iPhone 16 Pro' \
+  test
+```
+
 ## Development commands
 
 ```bash
@@ -122,6 +183,7 @@ The release script verifies a clean, up-to-date `main`, runs checks and build, b
 Pico is built with:
 
 - TanStack Start, Router, Query, Store, Hotkeys, and Pacer
+- Native SwiftUI for macOS and iOS
 - React 19
 - TypeScript
 - Vite+ and Nitro

package/bin/pico.mjs

@@ -2,6 +2,7 @@
 
 import { spawn, spawnSync } from "node:child_process"
 import { existsSync, readFileSync } from "node:fs"
+import { createServer } from "node:net"
 import process from "node:process"
 import { dirname, join } from "node:path"
 import { fileURLToPath } from "node:url"
@@ -9,6 +10,34 @@ import { fileURLToPath } from "node:url"
 const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)))
 const packageJsonPath = join(packageRoot, "package.json")
 const serverEntry = join(packageRoot, ".output", "server", "index.mjs")
+const minimumNodeVersion = [22, 19, 0]
+const minimumNodeVersionLabel = "22.19.0"
+const portSearchLimit = 100
+
+function nodeVersionMeetsMinimum(version) {
+  const parts = version.split(".").map((part) => Number(part))
+
+  for (let index = 0; index < minimumNodeVersion.length; index += 1) {
+    const actual = Number.isFinite(parts[index]) ? parts[index] : 0
+    const required = minimumNodeVersion[index]
+    if (actual > required) return true
+    if (actual < required) return false
+  }
+
+  return true
+}
+
+function ensureSupportedNodeVersion() {
+  if (nodeVersionMeetsMinimum(process.versions.node)) return
+
+  console.error(
+    `Pico requires Node.js >=${minimumNodeVersionLabel}; current version is ${process.versions.node}.`
+  )
+  console.error("Upgrade Node.js and run Pico again.")
+  process.exit(1)
+}
+
+ensureSupportedNodeVersion()
 
 function readPackageMetadata() {
   try {
@@ -41,7 +70,7 @@ Commands:
   update           Update the globally installed Pico package to latest
 
 Options:
-  --port <port>    Port to listen on (default: 3141)
+  --port <port>    Port to listen on (default: 3141; tries next free port)
   --host <host>    Host to bind to
   --open           Open Pico in your browser (default)
   --no-open        Do not open a browser window
@@ -209,6 +238,67 @@ function browserHostFor(host) {
   return host
 }
 
+function normalizePort(port) {
+  const portNumber = Number(port)
+  if (!Number.isInteger(portNumber) || portNumber < 0 || portNumber > 65_535) {
+    console.error(`Invalid port: ${port}`)
+    process.exit(1)
+  }
+  return portNumber
+}
+
+function canRetryPortError(error) {
+  return error?.code === "EADDRINUSE"
+}
+
+function isPortAvailable(port, host) {
+  return new Promise((resolve, reject) => {
+    const probe = createServer()
+    const listenOptions = host ? { port, host } : { port }
+
+    probe.once("error", (error) => {
+      if (canRetryPortError(error)) {
+        resolve(false)
+        return
+      }
+      reject(error)
+    })
+    probe.once("listening", () => {
+      probe.close((error) => {
+        if (error) {
+          reject(error)
+          return
+        }
+        resolve(true)
+      })
+    })
+    probe.listen(listenOptions)
+  })
+}
+
+async function resolveAvailablePort(port, host) {
+  const requestedPort = normalizePort(port)
+  if (requestedPort === 0) return String(requestedPort)
+
+  const lastPort = Math.min(65_535, requestedPort + portSearchLimit - 1)
+
+  for (let candidate = requestedPort; candidate <= lastPort; candidate += 1) {
+    if (await isPortAvailable(candidate, host)) {
+      if (candidate !== requestedPort) {
+        console.warn(
+          `Port ${requestedPort} is not available; using ${candidate} instead.`
+        )
+      }
+      return String(candidate)
+    }
+  }
+
+  console.error(
+    `No available port found between ${requestedPort} and ${lastPort}.`
+  )
+  process.exit(1)
+}
+
 async function waitForServer(url, timeoutMs = 15_000) {
   const startedAt = Date.now()
 
@@ -254,6 +344,18 @@ if (!existsSync(serverEntry)) {
   process.exit(1)
 }
 
+try {
+  options.port = await resolveAvailablePort(options.port, options.host)
+} catch (error) {
+  console.error(
+    `Could not check port ${options.port}${
+      options.host ? ` on ${options.host}` : ""
+    }.`
+  )
+  console.error(error?.message ?? String(error))
+  process.exit(1)
+}
+
 const url = `http://${browserHostFor(options.host)}:${options.port}`
 
 console.log(`Starting Pico at ${url}`)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@alivault/pico",
-  "version": "0.13.0",
-  "description": "A local, keyboard-friendly browser workspace for Pi coding-agent sessions.",
+  "version": "0.14.0",
+  "description": "A local workspace for Pi coding-agent sessions with browser, macOS, and iOS clients.",
   "license": "AGPL-3.0-only",
   "type": "module",
   "bin": {
@@ -25,7 +25,7 @@
     "url": "https://github.com/alivault/pico/issues"
   },
   "engines": {
-    "node": ">=20.6.0"
+    "node": ">=22.19.0"
   },
   "publishConfig": {
     "access": "public"
@@ -44,7 +44,7 @@
     "update:pi": "pnpm update @earendil-works/pi-coding-agent --latest"
   },
   "dependencies": {
-    "@earendil-works/pi-coding-agent": "0.74.0",
+    "@earendil-works/pi-coding-agent": "0.80.6",
     "node-pty": "^1.1.0",
     "tslib": "^2.8.1"
   },