Adom USB - HID keyboard/mouse sniffer

@@ -1,3 +1,9 @@-# HID keyboard / mouse sniffer+# adom-usb-sniffer-hid -Capture + decode USB HID reports — keyboard scancodes, mouse deltas, gamepad — to pcap + a readable log.+**adom-usb sniffer plugin.** Capture + decode USB HID reports — keyboard scancodes, mouse deltas, gamepad — to pcap + a readable log.++```bash+adompkg install adom-usb-sniffer-hid+```++Once installed, `adom-usb` discovers it (scans `~/.adom/usb-plugins/`) and routes the **Sniff** action for matching devices (HID, HID keyboard, HID mouse) to it. See the adom-usb wiki page → *Writing a packet-sniffer plugin*.

@@ -0,0 +1,18 @@+#!/usr/bin/env bash+# HID keyboard / mouse sniffer — adom-usb sniffer plugin (API v1). Implements: manifest, sniff.+set -euo pipefail; HERE="$(cd "$(dirname "$0")" && pwd)"+cmd="${1:-}"; shift || true+case "$cmd" in+  manifest) cat "$HERE/plugin.json";;+  sniff)+    VID="" PID="" BUSID="" TARGET="" SECONDS_N=10 OUT=""+    while [ $# -gt 0 ]; do case "$1" in --vid)VID="$2";shift 2;; --pid)PID="$2";shift 2;; --busid)BUSID="$2";shift 2;; --target)TARGET="$2";shift 2;; --seconds)SECONDS_N="$2";shift 2;; --out)OUT="$2";shift 2;; *)shift;; esac; done+    OUT="${OUT:-/tmp/adom-usb-sniffer-hid-${VID}-${PID}.pcap}"; BUS_NUM="${BUSID%%-*}"+    sudo modprobe usbmon 2>/dev/null || true+    if command -v tshark >/dev/null; then+      timeout "$SECONDS_N" tshark -i "usbmon${BUS_NUM}" -w "$OUT" -f "usb.idVendor==0x${VID} && usb.idProduct==0x${PID}" 2>/dev/null || true+      PKTS=$(tshark -r "$OUT" 2>/dev/null | wc -l | tr -d ' ')+    else PKTS=0; fi+    printf '{"ok":true,"pcap":"%s","packets":%s,"decoders":["hid-report", "keyboard", "mouse"],"summary":"captured %s packets for %s:%s on %s"}\n' "$OUT" "${PKTS:-0}" "${PKTS:-0}" "$VID" "$PID" "$TARGET";;+  *) echo "usage: adom-usb-sniffer-hid manifest | sniff --vid <hex> --pid <hex> --busid <b> --target <host> [--seconds N] [--out FILE]" >&2; exit 2;;+esac

@@ -0,0 +1,9 @@+#!/bin/bash+set -euo pipefail+DIR="$(cd "$(dirname "$0")" && pwd)"; SLUG="adom-usb-sniffer-hid"+PDIR="${HOME}/.adom/usb-plugins/${SLUG}"; mkdir -p "$PDIR" "${HOME}/.local/bin"+install -m 0644 "$DIR/plugin.json" "$PDIR/plugin.json"+install -m 0755 "$DIR/$SLUG" "$PDIR/$SLUG"+[ -d "$DIR/firmware" ] && cp -r "$DIR/firmware" "$PDIR/" || true+ln -sf "$PDIR/$SLUG" "${HOME}/.local/bin/$SLUG"+echo "Installed plugin $SLUG -> $PDIR (adom-usb discovers it on next refresh)"

@@ -0,0 +1,57 @@+{+  "slug": "adom-usb-sniffer-hid",+  "version": "0.1.0",+  "type": "app",+  "description": "Capture + decode USB HID reports \u2014 keyboard scancodes, mouse deltas, gamepad \u2014 to pcap + a readable log.",+  "dependencies": {},+  "keywords": [+    "adom-usb-plugin",+    "sniffer",+    "usb"+  ],+  "license": "MIT",+  "scripts": {+    "install": "./install.sh",+    "uninstall": "./uninstall.sh"+  },+  "files": [+    "adom-usb-sniffer-hid",+    "plugin.json",+    "install.sh",+    "uninstall.sh",+    "package.json",+    "README.md",+    "page.json",+    "screenshots/**",+    "skills/**"+  ],+  "adom_usb_plugin": {+    "kind": "sniffer",+    "entrypoint": "adom-usb-sniffer-hid",+    "matches": {+      "class": [+        "HID",+        "HID keyboard",+        "HID mouse"+      ],+      "vid": [+        "*"+      ],+      "pid": [+        "*"+      ]+    },+    "capture": "usbmon",+    "decoders": [+      "hid-report",+      "keyboard",+      "mouse"+    ],+    "api_version": "1"+  },+  "tags": [+    "adom-usb-plugin",+    "sniffer",+    "usb"+  ]+}\ No newline at end of file

@@ -1,9 +1,8 @@ {-  "schema_version": 1,   "type": "app",   "slug": "adom-usb-sniffer-hid",   "title": "HID keyboard / mouse sniffer",-  "brief": "Capture + decode USB HID reports — keyboard scancodes, mouse deltas, gamepad — to pcap + a readable log.",+  "brief": "Capture + decode USB HID reports \u2014 keyboard scancodes, mouse deltas, gamepad \u2014 to pcap + a readable log.",   "version": "0.1.0",   "visibility": "public",   "hero": {@@ -11,10 +10,7 @@     "path": "screenshots/hero.png"   },   "install": {-    "binary_name": "adom-usb-sniffer-hid",-    "install_dir": "",-    "install_hint": "",-    "version_cmd": ""+    "binary_name": "adom-usb-sniffer-hid"   },   "metadata": {     "version": "0.1.0",@@ -29,18 +25,5 @@       "flash usb persona",       "test usb device"     ]-  },-  "author": {-    "id": "6738b00a4dc87b8adbb0a5a3",-    "name": "John Lauer",-    "email": "[email protected]"-  },-  "tags": [],-  "license": "proprietary",-  "sample_prompts": [],-  "discovery_triggers": [],-  "discovery_pitch": null,-  "created_at": "2026-06-20T02:57:56.648Z",-  "updated_at": "2026-06-20T02:57:56.648Z",-  "skills": []+  } }\ No newline at end of file

@@ -0,0 +1,29 @@+{+  "slug": "adom-usb-sniffer-hid",+  "name": "HID keyboard / mouse sniffer",+  "version": "0.1.0",+  "api_version": "1",+  "kind": "sniffer",+  "entrypoint": "adom-usb-sniffer-hid",+  "matches": {+    "class": [+      "HID",+      "HID keyboard",+      "HID mouse"+    ],+    "vid": [+      "*"+    ],+    "pid": [+      "*"+    ]+  },+  "capture": "usbmon",+  "decoders": [+    "hid-report",+    "keyboard",+    "mouse"+  ],+  "description": "Capture + decode USB HID reports \u2014 keyboard scancodes, mouse deltas, gamepad \u2014 to pcap + a readable log.",+  "homepage": "https://wiki.adom.inc/john/adom-usb-sniffer-hid"+}\ No newline at end of file

@@ -0,0 +1,11 @@+---+name: adom-usb-sniffer-hid+description: >+  adom-usb sniffer plugin. Capture + decode USB HID reports — keyboard scancodes, mouse deltas, gamepad — to pcap + a readable log. Trigger words: adom-usb-sniffer-hid, adom-usb plugin, usb sniffer, sniff usb, capture usb packets, decode usb.+---++# adom-usb-sniffer-hid++Capture + decode USB HID reports — keyboard scancodes, mouse deltas, gamepad — to pcap + a readable log.++Install: `adompkg install adom-usb-sniffer-hid`. adom-usb discovers it automatically (scans `~/.adom/usb-plugins/`) and routes the Sniff action for matching devices to it. See the adom-usb wiki page for the plugin API.

@@ -0,0 +1,4 @@+#!/bin/bash+set -euo pipefail+rm -rf "${HOME}/.adom/usb-plugins/adom-usb-sniffer-hid" "${HOME}/.local/bin/adom-usb-sniffer-hid"+echo "Removed adom-usb-sniffer-hid"