@steipete/peekaboo 3.0.0-beta1 → 3.0.0-beta3

package/README.md

@@ -12,7 +12,7 @@
 [![Ask DeepWiki](https://img.shields.io/badge/Ask-DeepWiki-0088cc?style=flat-square)](https://deepwiki.com/steipete/peekaboo)
 
 Peekaboo brings high-fidelity screen capture, AI analysis, and complete GUI automation to macOS. Version 3 adds native agent flows and multi-screen automation across the CLI and MCP server.
-> Note: v3 is currently in beta (3.0.0-beta1) and has a few known issues; see the changelog for details.
+> Note: v3 is currently in beta (3.0.0-beta3) and has a few known issues; see the changelog for details.
 
 ## What you get
 - Pixel-accurate captures (windows, screens, menu bar) with optional Retina 2x scaling.
@@ -39,8 +39,8 @@ Peekaboo brings high-fidelity screen capture, AI analysis, and complete GUI auto
 peekaboo image --mode screen --retina --path ~/Desktop/screen.png
 
 # Click a button by label (captures, resolves, and clicks in one go)
-peekaboo see --app Safari --json-output | jq -r '.data.session_id' | read SID
-peekaboo click --on "Reload this page" --session "$SID"
+peekaboo see --app Safari --json-output | jq -r '.data.snapshot_id' | read SNAPSHOT
+peekaboo click --on "Reload this page" --snapshot "$SNAPSHOT"
 
 # Run a natural-language automation
 peekaboo "Open Notes and create a TODO list with three items"
@@ -64,8 +64,8 @@ npx -y @steipete/peekaboo
 
 | Command | Key flags / subcommands | What it does |
 | --- | --- | --- |
-| [see](docs/commands/see.md) | `--app`, `--mode screen/window`, `--retina`, `--json-output` | Capture and annotate UI, return session + element IDs |
-| [click](docs/commands/click.md) | `--on <id/query>`, `--session`, `--wait`, coords | Click by element ID, label, or coordinates |
+| [see](docs/commands/see.md) | `--app`, `--mode screen/window`, `--retina`, `--json-output` | Capture and annotate UI, return snapshot + element IDs |
+| [click](docs/commands/click.md) | `--on <id/query>`, `--snapshot`, `--wait`, coords | Click by element ID, label, or coordinates |
 | [type](docs/commands/type.md) | `--text`, `--clear`, `--delay-ms` | Enter text with pacing options |
 | [press](docs/commands/press.md) | key names, `--repeat` | Special keys and sequences |
 | [hotkey](docs/commands/hotkey.md) | combos like `cmd,shift,t` | Modifier combos (cmd/ctrl/alt/shift) |
@@ -82,14 +82,14 @@ npx -y @steipete/peekaboo
 | [dialog](docs/commands/dialog.md) | `list`, `click`, `input`, `file`, `dismiss` | Drive system dialogs (open/save/etc.) |
 | [image](docs/commands/image.md) | `--mode screen/window/menu`, `--retina`, `--analyze` | Screenshot screen/window/menu bar (+analyze) |
 | [list](docs/commands/list.md) | `apps`, `windows`, `screens`, `menubar`, `permissions` | Enumerate apps, windows, screens, permissions |
-| [tools](docs/commands/tools.md) | `--source native\|mcp`, `--server <name>` | Inspect native + MCP tools |
+| [tools](docs/commands/tools.md) | `--verbose`, `--json-output`, `--no-sort` | Inspect native Peekaboo tools |
 | [config](docs/commands/config.md) | `init`, `show`, `add`, `login`, `models` | Manage credentials/providers/settings |
 | [permissions](docs/commands/permissions.md) | `status`, `grant` | Check/grant required macOS permissions |
 | [run](docs/commands/run.md) | `.peekaboo.json`, `--output`, `--no-fail-fast` | Execute `.peekaboo.json` automation scripts |
 | [sleep](docs/commands/sleep.md) | `--duration` (ms) | Millisecond delays between steps |
-| [clean](docs/commands/clean.md) | `--all-sessions`, `--older-than`, `--session` | Prune sessions and caches |
+| [clean](docs/commands/clean.md) | `--all-snapshots`, `--older-than`, `--snapshot` | Prune snapshots and caches |
 | [agent](docs/commands/agent.md) | `--model`, `--dry-run`, `--resume`, `--max-steps`, audio | Natural-language multi-step automation |
-| [mcp](docs/commands/mcp.md) | `serve`, `list`, `add`, `enable/disable`, `test` | Manage external MCP servers and serve Peekaboo |
+| [mcp](docs/commands/mcp.md) | `serve` (default) | Run Peekaboo as an MCP server |
 
 ## Models and providers
 - OpenAI: GPT-5.1 (default) and GPT-4.1/4o vision

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steipete/peekaboo",
-  "version": "3.0.0-beta1",
+  "version": "3.0.0-beta3",
   "description": "macOS automation MCP server with screen capture, UI interaction, and AI analysis",
   "private": false,
   "type": "module",
@@ -21,11 +21,12 @@
     "build:swift": "./runner ./scripts/build-swift-arm.sh",
     "build:swift:all": "./runner ./scripts/build-swift-universal.sh",
     "build:polter": "./runner polter peekaboo --version",
+    "app:restart": "./runner ./scripts/restart-peekaboo.sh",
     "build": "pnpm run build:cli",
     "test:safe": "./runner swift test --package-path Apps/CLI -Xswiftc -DPEEKABOO_SKIP_AUTOMATION --no-parallel",
     "test:automation": "PEEKABOO_INCLUDE_AUTOMATION_TESTS=true ./runner swift test --package-path Apps/CLI --no-parallel",
     "test:automation:read": "RUN_AUTOMATION_READ=true PEEKABOO_INCLUDE_AUTOMATION_TESTS=true ./runner swift test --package-path Apps/CLI --no-parallel",
-    "test:automation:local": "./runner bash -lc 'cd Apps/CLI && BIN_PATH=$(swift build --show-bin-path) && RUN_LOCAL_TESTS=true PEEKABOO_INCLUDE_AUTOMATION_TESTS=true PEEKABOO_CLI_PATH=\"$BIN_PATH/peekaboo\" swift test --no-parallel'",
+    "test:automation:local": "./runner bash -lc 'BIN_PATH=$(swift build --package-path Apps/CLI --show-bin-path) && RUN_LOCAL_TESTS=true PEEKABOO_INCLUDE_AUTOMATION_TESTS=true PEEKABOO_CLI_PATH=\"$BIN_PATH/peekaboo\" swift test --package-path Apps/CLI --no-parallel'",
     "test:all": "./runner bash -lc 'set -euo pipefail; cd Apps/CLI && swift test -Xswiftc -DPEEKABOO_SKIP_AUTOMATION --no-parallel && PEEKABOO_INCLUDE_AUTOMATION_TESTS=true swift test --no-parallel'",
     "test": "pnpm run test:safe",
     "tachikoma:test:integration": "./runner bash -lc 'cd Tachikoma && source ~/.profile && INTEGRATION_TESTS=1 swift test --parallel -Xswiftc -DLIVE_PROVIDER_TESTS'",
@@ -33,7 +34,7 @@
     "lint": "pnpm run lint:swift",
     "format:swift": "./runner swiftformat .",
     "format": "pnpm run format:swift",
-    "prepare-release": "./runner node scripts/prepare-release.js",
+    "prepare-release": "node scripts/prepare-release.js",
     "docs:list": "./runner node scripts/docs-list.mjs",
     "lint:docs": "./runner node scripts/docs-lint.mjs",
     "polter": "FORCE_COLOR=1 CLICOLOR_FORCE=1 NODE_PATH=../poltergeist/node_modules script -q /dev/null ./runner node ../poltergeist/dist/polter.js",
@@ -70,10 +71,13 @@
   "engines": {
     "node": ">=22.0.0"
   },
-  "os": ["darwin"],
-  "cpu": ["x64", "arm64"],
-  "dependencies": {},
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "arm64"
+  ],
   "devDependencies": {
-    "chrome-devtools-mcp": "0.10.1"
+    "chrome-devtools-mcp": "0.12.1"
   }
 }