@oriro/orirocli 0.1.8 → 0.1.11

package/skills/peekaboo/SKILL.md

@@ -1,217 +1,217 @@
----
-provider: ORIRO.ai
-copyright: Copyright (c) 2026 ORIRO.ai
-watermark: ORIRO
-disable-model-invocation: true
-name: peekaboo
-description: "Capture and automate macOS UI with the Peekaboo CLI."
-homepage: https://peekaboo.boo
-metadata:
-  {
-    "oriro":
-      {
-        "emoji": "👀",
-        "os": ["darwin"],
-        "requires": { "bins": ["peekaboo"] },
-        "install":
-          [
-            {
-              "id": "brew",
-              "kind": "brew",
-              "formula": "oriro/tap/peekaboo",
-              "bins": ["peekaboo"],
-              "label": "Install Peekaboo (brew)",
-            },
-          ],
-      },
-  }
----
-
-# Peekaboo
-
-Peekaboo is a full macOS UI automation CLI: capture/inspect screens, target UI
-elements, drive input, and manage apps/windows/menus. Commands share a snapshot
-cache and support `--json`/`-j` for scripting. Run `peekaboo` or
-`peekaboo <cmd> --help` for flags; `peekaboo --version` prints build metadata.
-Tip: run via `polter peekaboo` to ensure fresh builds.
-
-## Oriro Bridge
-
-The Oriro macOS app hosts Peekaboo Bridge at
-`~/Library/Application Support/Oriro/bridge.sock`. Before running Peekaboo
-from Oriro, select that socket so the CLI uses the app's Screen Recording
-and Accessibility grants instead of starting its standalone daemon:
-
-```bash
-export PEEKABOO_BRIDGE_SOCKET="${PEEKABOO_BRIDGE_SOCKET:-$HOME/Library/Application Support/Oriro/bridge.sock}"
-```
-
-Confirm routing with `peekaboo bridge status --json`; `hostKind` must be `gui`
-and the socket path must end in `Oriro/bridge.sock`.
-
-## Features (all CLI capabilities, excluding agent/MCP)
-
-Core
-
-- `bridge`: inspect Peekaboo Bridge host connectivity
-- `capture`: live capture or video ingest + frame extraction
-- `clean`: prune snapshot cache and temp files
-- `config`: init/show/edit/validate, providers, models, credentials
-- `image`: capture screenshots (screen/window/menu bar regions)
-- `learn`: print the full agent guide + tool catalog
-- `list`: apps, windows, screens, menubar, permissions
-- `permissions`: check Screen Recording/Accessibility status
-- `run`: execute `.peekaboo.json` scripts
-- `sleep`: pause execution for a duration
-- `tools`: list available tools with filtering/display options
-
-Interaction
-
-- `click`: target by ID/query/coords with smart waits
-- `drag`: drag & drop across elements/coords/Dock
-- `hotkey`: modifier combos like `cmd,shift,t`
-- `move`: cursor positioning with optional smoothing
-- `paste`: set clipboard -> paste -> restore
-- `press`: special-key sequences with repeats
-- `scroll`: directional scrolling (targeted + smooth)
-- `swipe`: gesture-style drags between targets
-- `type`: text + control keys (`--clear`, delays)
-
-System
-
-- `app`: launch/quit/relaunch/hide/unhide/switch/list apps
-- `clipboard`: read/write clipboard (text/images/files)
-- `dialog`: click/input/file/dismiss/list system dialogs
-- `dock`: launch/right-click/hide/show/list Dock items
-- `menu`: click/list application menus + menu extras
-- `menubar`: list/click status bar items
-- `open`: enhanced `open` with app targeting + JSON payloads
-- `space`: list/switch/move-window (Spaces)
-- `visualizer`: exercise Peekaboo visual feedback animations
-- `window`: close/minimize/maximize/move/resize/focus/list
-
-Vision
-
-- `see`: annotated UI maps, snapshot IDs, optional analysis
-
-Global runtime flags
-
-- `--json`/`-j`, `--verbose`/`-v`, `--log-level <level>`
-- `--no-remote`, `--bridge-socket <path>`
-
-## Quickstart (happy path)
-
-```bash
-peekaboo permissions
-peekaboo list apps --json
-peekaboo see --annotate --path /tmp/peekaboo-see.png
-peekaboo click --on B1
-peekaboo type "Hello" --return
-```
-
-## Common targeting parameters (most interaction commands)
-
-- App/window: `--app`, `--pid`, `--window-title`, `--window-id`, `--window-index`
-- Snapshot targeting: `--snapshot` (ID from `see`; defaults to latest)
-- Element/coords: `--on`/`--id` (element ID), `--coords x,y`
-- Focus control: `--no-auto-focus`, `--space-switch`, `--bring-to-current-space`,
-  `--focus-timeout-seconds`, `--focus-retry-count`
-
-## Common capture parameters
-
-- Output: `--path`, `--format png|jpg`, `--retina`
-- Targeting: `--mode screen|window|frontmost`, `--screen-index`,
-  `--window-title`, `--window-id`
-- Analysis: `--analyze "prompt"`, `--annotate`
-- Capture engine: `--capture-engine auto|classic|cg|modern|sckit`
-
-## Common motion/typing parameters
-
-- Timing: `--duration` (drag/swipe), `--steps`, `--delay` (type/scroll/press)
-- Human-ish movement: `--profile human|linear`, `--wpm` (typing)
-- Scroll: `--direction up|down|left|right`, `--amount <ticks>`, `--smooth`
-
-## Examples
-
-### See -> click -> type (most reliable flow)
-
-```bash
-peekaboo see --app Safari --window-title "Login" --annotate --path /tmp/see.png
-peekaboo click --on B3 --app Safari
-peekaboo type "user@example.com" --app Safari
-peekaboo press tab --count 1 --app Safari
-peekaboo type "supersecret" --app Safari --return
-```
-
-### Target by window id
-
-```bash
-peekaboo list windows --app "Visual Studio Code" --json
-peekaboo click --window-id 12345 --coords 120,160
-peekaboo type "Hello from Peekaboo" --window-id 12345
-```
-
-### Capture screenshots + analyze
-
-```bash
-peekaboo image --mode screen --screen-index 0 --retina --path /tmp/screen.png
-peekaboo image --app Safari --window-title "Dashboard" --analyze "Summarize KPIs"
-peekaboo see --mode screen --screen-index 0 --analyze "Summarize the dashboard"
-```
-
-### Live capture (motion-aware)
-
-```bash
-peekaboo capture live --mode region --region 100,100,800,600 --duration 30 \
-  --active-fps 8 --idle-fps 2 --highlight-changes --path /tmp/capture
-```
-
-### App + window management
-
-```bash
-peekaboo app launch "Safari" --open https://example.com
-peekaboo window focus --app Safari --window-title "Example"
-peekaboo window set-bounds --app Safari --x 50 --y 50 --width 1200 --height 800
-peekaboo app quit --app Safari
-```
-
-### Menus, menubar, dock
-
-```bash
-peekaboo menu click --app Safari --item "New Window"
-peekaboo menu click --app TextEdit --path "Format > Font > Show Fonts"
-peekaboo menu click-extra --title "WiFi"
-peekaboo dock launch Safari
-peekaboo menubar list --json
-```
-
-### Mouse + gesture input
-
-```bash
-peekaboo move 500,300 --smooth
-peekaboo drag --from B1 --to T2
-peekaboo swipe --from-coords 100,500 --to-coords 100,200 --duration 800
-peekaboo scroll --direction down --amount 6 --smooth
-```
-
-### Keyboard input
-
-```bash
-peekaboo hotkey --keys "cmd,shift,t"
-peekaboo press escape
-peekaboo type "Line 1\nLine 2" --delay 10
-```
-
-Notes
-
-- Requires Screen Recording + Accessibility permissions.
-- In Oriro subprocesses, set `PEEKABOO_BRIDGE_SOCKET` as shown above. Do not
-  pass `--no-remote` unless the calling process has its own Screen Recording
-  grant.
-- Diagnose subprocess capture failures with `peekaboo bridge status --json`,
-  then `peekaboo permissions status --json`, then a normal Bridge-routed
-  capture such as `peekaboo image --mode screen --json`.
-- On macOS 15+, the "bypass private window picker" prompt is separate from the
-  base Screen Recording grant; it can appear even when Bridge permissions are
-  otherwise correct.
-- Use `peekaboo see --annotate` to identify targets before clicking.
+---
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+watermark: ORIRO
+disable-model-invocation: true
+name: peekaboo
+description: "Capture and automate macOS UI with the Peekaboo CLI."
+homepage: https://peekaboo.boo
+metadata:
+  {
+    "oriro":
+      {
+        "emoji": "👀",
+        "os": ["darwin"],
+        "requires": { "bins": ["peekaboo"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "oriro/tap/peekaboo",
+              "bins": ["peekaboo"],
+              "label": "Install Peekaboo (brew)",
+            },
+          ],
+      },
+  }
+---
+
+# Peekaboo
+
+Peekaboo is a full macOS UI automation CLI: capture/inspect screens, target UI
+elements, drive input, and manage apps/windows/menus. Commands share a snapshot
+cache and support `--json`/`-j` for scripting. Run `peekaboo` or
+`peekaboo <cmd> --help` for flags; `peekaboo --version` prints build metadata.
+Tip: run via `polter peekaboo` to ensure fresh builds.
+
+## Oriro Bridge
+
+The Oriro macOS app hosts Peekaboo Bridge at
+`~/Library/Application Support/Oriro/bridge.sock`. Before running Peekaboo
+from Oriro, select that socket so the CLI uses the app's Screen Recording
+and Accessibility grants instead of starting its standalone daemon:
+
+```bash
+export PEEKABOO_BRIDGE_SOCKET="${PEEKABOO_BRIDGE_SOCKET:-$HOME/Library/Application Support/Oriro/bridge.sock}"
+```
+
+Confirm routing with `peekaboo bridge status --json`; `hostKind` must be `gui`
+and the socket path must end in `Oriro/bridge.sock`.
+
+## Features (all CLI capabilities, excluding agent/MCP)
+
+Core
+
+- `bridge`: inspect Peekaboo Bridge host connectivity
+- `capture`: live capture or video ingest + frame extraction
+- `clean`: prune snapshot cache and temp files
+- `config`: init/show/edit/validate, providers, models, credentials
+- `image`: capture screenshots (screen/window/menu bar regions)
+- `learn`: print the full agent guide + tool catalog
+- `list`: apps, windows, screens, menubar, permissions
+- `permissions`: check Screen Recording/Accessibility status
+- `run`: execute `.peekaboo.json` scripts
+- `sleep`: pause execution for a duration
+- `tools`: list available tools with filtering/display options
+
+Interaction
+
+- `click`: target by ID/query/coords with smart waits
+- `drag`: drag & drop across elements/coords/Dock
+- `hotkey`: modifier combos like `cmd,shift,t`
+- `move`: cursor positioning with optional smoothing
+- `paste`: set clipboard -> paste -> restore
+- `press`: special-key sequences with repeats
+- `scroll`: directional scrolling (targeted + smooth)
+- `swipe`: gesture-style drags between targets
+- `type`: text + control keys (`--clear`, delays)
+
+System
+
+- `app`: launch/quit/relaunch/hide/unhide/switch/list apps
+- `clipboard`: read/write clipboard (text/images/files)
+- `dialog`: click/input/file/dismiss/list system dialogs
+- `dock`: launch/right-click/hide/show/list Dock items
+- `menu`: click/list application menus + menu extras
+- `menubar`: list/click status bar items
+- `open`: enhanced `open` with app targeting + JSON payloads
+- `space`: list/switch/move-window (Spaces)
+- `visualizer`: exercise Peekaboo visual feedback animations
+- `window`: close/minimize/maximize/move/resize/focus/list
+
+Vision
+
+- `see`: annotated UI maps, snapshot IDs, optional analysis
+
+Global runtime flags
+
+- `--json`/`-j`, `--verbose`/`-v`, `--log-level <level>`
+- `--no-remote`, `--bridge-socket <path>`
+
+## Quickstart (happy path)
+
+```bash
+peekaboo permissions
+peekaboo list apps --json
+peekaboo see --annotate --path /tmp/peekaboo-see.png
+peekaboo click --on B1
+peekaboo type "Hello" --return
+```
+
+## Common targeting parameters (most interaction commands)
+
+- App/window: `--app`, `--pid`, `--window-title`, `--window-id`, `--window-index`
+- Snapshot targeting: `--snapshot` (ID from `see`; defaults to latest)
+- Element/coords: `--on`/`--id` (element ID), `--coords x,y`
+- Focus control: `--no-auto-focus`, `--space-switch`, `--bring-to-current-space`,
+  `--focus-timeout-seconds`, `--focus-retry-count`
+
+## Common capture parameters
+
+- Output: `--path`, `--format png|jpg`, `--retina`
+- Targeting: `--mode screen|window|frontmost`, `--screen-index`,
+  `--window-title`, `--window-id`
+- Analysis: `--analyze "prompt"`, `--annotate`
+- Capture engine: `--capture-engine auto|classic|cg|modern|sckit`
+
+## Common motion/typing parameters
+
+- Timing: `--duration` (drag/swipe), `--steps`, `--delay` (type/scroll/press)
+- Human-ish movement: `--profile human|linear`, `--wpm` (typing)
+- Scroll: `--direction up|down|left|right`, `--amount <ticks>`, `--smooth`
+
+## Examples
+
+### See -> click -> type (most reliable flow)
+
+```bash
+peekaboo see --app Safari --window-title "Login" --annotate --path /tmp/see.png
+peekaboo click --on B3 --app Safari
+peekaboo type "user@example.com" --app Safari
+peekaboo press tab --count 1 --app Safari
+peekaboo type "supersecret" --app Safari --return
+```
+
+### Target by window id
+
+```bash
+peekaboo list windows --app "Visual Studio Code" --json
+peekaboo click --window-id 12345 --coords 120,160
+peekaboo type "Hello from Peekaboo" --window-id 12345
+```
+
+### Capture screenshots + analyze
+
+```bash
+peekaboo image --mode screen --screen-index 0 --retina --path /tmp/screen.png
+peekaboo image --app Safari --window-title "Dashboard" --analyze "Summarize KPIs"
+peekaboo see --mode screen --screen-index 0 --analyze "Summarize the dashboard"
+```
+
+### Live capture (motion-aware)
+
+```bash
+peekaboo capture live --mode region --region 100,100,800,600 --duration 30 \
+  --active-fps 8 --idle-fps 2 --highlight-changes --path /tmp/capture
+```
+
+### App + window management
+
+```bash
+peekaboo app launch "Safari" --open https://example.com
+peekaboo window focus --app Safari --window-title "Example"
+peekaboo window set-bounds --app Safari --x 50 --y 50 --width 1200 --height 800
+peekaboo app quit --app Safari
+```
+
+### Menus, menubar, dock
+
+```bash
+peekaboo menu click --app Safari --item "New Window"
+peekaboo menu click --app TextEdit --path "Format > Font > Show Fonts"
+peekaboo menu click-extra --title "WiFi"
+peekaboo dock launch Safari
+peekaboo menubar list --json
+```
+
+### Mouse + gesture input
+
+```bash
+peekaboo move 500,300 --smooth
+peekaboo drag --from B1 --to T2
+peekaboo swipe --from-coords 100,500 --to-coords 100,200 --duration 800
+peekaboo scroll --direction down --amount 6 --smooth
+```
+
+### Keyboard input
+
+```bash
+peekaboo hotkey --keys "cmd,shift,t"
+peekaboo press escape
+peekaboo type "Line 1\nLine 2" --delay 10
+```
+
+Notes
+
+- Requires Screen Recording + Accessibility permissions.
+- In Oriro subprocesses, set `PEEKABOO_BRIDGE_SOCKET` as shown above. Do not
+  pass `--no-remote` unless the calling process has its own Screen Recording
+  grant.
+- Diagnose subprocess capture failures with `peekaboo bridge status --json`,
+  then `peekaboo permissions status --json`, then a normal Bridge-routed
+  capture such as `peekaboo image --mode screen --json`.
+- On macOS 15+, the "bypass private window picker" prompt is separate from the
+  base Screen Recording grant; it can appear even when Bridge permissions are
+  otherwise correct.
+- Use `peekaboo see --annotate` to identify targets before clicking.

package/skills/pyproject.toml

@@ -1,10 +1,10 @@
-[tool.ruff]
-target-version = "py310"
-line-length = 100
-
-[tool.ruff.lint]
-select = ["E9", "F63", "F7", "F82", "I"]
-
-[tool.pytest.ini_options]
-testpaths = ["skills"]
-python_files = ["test_*.py"]
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E9", "F63", "F7", "F82", "I"]
+
+[tool.pytest.ini_options]
+testpaths = ["skills"]
+python_files = ["test_*.py"]

package/skills/python-debugpy/SKILL.md

@@ -1,76 +1,76 @@
----
-provider: ORIRO.ai
-copyright: Copyright (c) 2026 ORIRO.ai
-watermark: ORIRO
-name: python-debugpy
-description: Debug Python with pdb, breakpoint(), post-mortem inspection, and debugpy remote attach.
-metadata: { "oriro": { "requires": { "bins": ["python3"] } } }
----
-
-# Python Debugpy
-
-Use when Python code needs interactive debugging: hidden locals, confusing state mutation, failing tests, subprocesses, long-running services, or remote/headless attach.
-
-Pick the smallest debugger that reaches the bad frame.
-
-## Choose
-
-- `breakpoint()`: local code, source edits ok, fastest path.
-- `python3 -m pdb`: no source edit, launch from the beginning.
-- `python3 -m pdb -c continue`: stop at an unhandled exception.
-- `debugpy`: remote/headless process, DAP client, already-running PID, or service startup race.
-
-## Commands
-
-```bash
-python3 -m pdb path/to/script.py arg1
-python3 -m pdb -c continue path/to/script.py
-python3 -c "import debugpy" || python3 -m pip install debugpy
-python3 -m debugpy --listen 127.0.0.1:5678 --wait-for-client path/to/script.py
-python3 -m debugpy --listen 127.0.0.1:5678 --wait-for-client -m package.module
-python3 -m debugpy --listen 127.0.0.1:5678 --pid <pid>
-```
-
-For source-edit attach:
-
-```py
-import debugpy
-
-debugpy.listen(("127.0.0.1", 5678))
-debugpy.wait_for_client()
-debugpy.breakpoint()
-```
-
-For post-mortem:
-
-```py
-import pdb, sys
-
-try:
-    run()
-except Exception:
-    pdb.post_mortem(sys.exc_info()[2])
-    raise
-```
-
-## pdb
-
-- Flow: `n`, `s`, `r`, `c`, `q`.
-- Stack/source: `w`, `u`, `d`, `a`, `l`, `ll`.
-- Values: `p expr`, `pp expr`, `display expr`.
-- Breakpoints: `b file.py:42`, `b func`, `b file.py:42, condition`, `cl <num>`.
-- Mutate/evaluate: `!statement`; full REPL: `interact`.
-
-## Rules
-
-- Reproduce with the smallest command/test first.
-- Disable parallel test workers for pdb; interactive stdin usually breaks inside worker pools.
-- Keep `debugpy` in the active env; do not add it as a project dependency unless the project already wants it.
-- Bind debug servers to `127.0.0.1`; do not expose `0.0.0.0` unless isolated or tunnelled.
-- Use unique ports for parallel sessions.
-- Treat `debugpy --pid` as injection; avoid security-sensitive or production targets unless explicitly approved.
-- If PID attach fails on Linux, check ptrace/container privileges before changing the target.
-- Cleanup before commit: `rg -n 'breakpoint\\(|pdb\\.set_trace|debugpy\\.' --type py`.
-- Rerun the normal project test/gate without the debugger.
-- `PYTHONBREAKPOINT=0` disables `breakpoint()`.
-- If a process is stuck after debugger detach, confirm it is not still paused at a breakpoint.
+---
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+watermark: ORIRO
+name: python-debugpy
+description: Debug Python with pdb, breakpoint(), post-mortem inspection, and debugpy remote attach.
+metadata: { "oriro": { "requires": { "bins": ["python3"] } } }
+---
+
+# Python Debugpy
+
+Use when Python code needs interactive debugging: hidden locals, confusing state mutation, failing tests, subprocesses, long-running services, or remote/headless attach.
+
+Pick the smallest debugger that reaches the bad frame.
+
+## Choose
+
+- `breakpoint()`: local code, source edits ok, fastest path.
+- `python3 -m pdb`: no source edit, launch from the beginning.
+- `python3 -m pdb -c continue`: stop at an unhandled exception.
+- `debugpy`: remote/headless process, DAP client, already-running PID, or service startup race.
+
+## Commands
+
+```bash
+python3 -m pdb path/to/script.py arg1
+python3 -m pdb -c continue path/to/script.py
+python3 -c "import debugpy" || python3 -m pip install debugpy
+python3 -m debugpy --listen 127.0.0.1:5678 --wait-for-client path/to/script.py
+python3 -m debugpy --listen 127.0.0.1:5678 --wait-for-client -m package.module
+python3 -m debugpy --listen 127.0.0.1:5678 --pid <pid>
+```
+
+For source-edit attach:
+
+```py
+import debugpy
+
+debugpy.listen(("127.0.0.1", 5678))
+debugpy.wait_for_client()
+debugpy.breakpoint()
+```
+
+For post-mortem:
+
+```py
+import pdb, sys
+
+try:
+    run()
+except Exception:
+    pdb.post_mortem(sys.exc_info()[2])
+    raise
+```
+
+## pdb
+
+- Flow: `n`, `s`, `r`, `c`, `q`.
+- Stack/source: `w`, `u`, `d`, `a`, `l`, `ll`.
+- Values: `p expr`, `pp expr`, `display expr`.
+- Breakpoints: `b file.py:42`, `b func`, `b file.py:42, condition`, `cl <num>`.
+- Mutate/evaluate: `!statement`; full REPL: `interact`.
+
+## Rules
+
+- Reproduce with the smallest command/test first.
+- Disable parallel test workers for pdb; interactive stdin usually breaks inside worker pools.
+- Keep `debugpy` in the active env; do not add it as a project dependency unless the project already wants it.
+- Bind debug servers to `127.0.0.1`; do not expose `0.0.0.0` unless isolated or tunnelled.
+- Use unique ports for parallel sessions.
+- Treat `debugpy --pid` as injection; avoid security-sensitive or production targets unless explicitly approved.
+- If PID attach fails on Linux, check ptrace/container privileges before changing the target.
+- Cleanup before commit: `rg -n 'breakpoint\\(|pdb\\.set_trace|debugpy\\.' --type py`.
+- Rerun the normal project test/gate without the debugger.
+- `PYTHONBREAKPOINT=0` disables `breakpoint()`.
+- If a process is stuck after debugger detach, confirm it is not still paused at a breakpoint.