@meta
  v: 1
  route: /wisp
  generated: 2026-06-07T00:00:00Z
  ttl: 1h

@intent
  purpose:    Wisp — a pocket Wi-Fi will-o'-the-wisp: a battery-powered ESP32 handheld that locks onto an access point (or a specific device) by MAC and lets you walk it down by ear, Geiger-style. The handheld sibling to the Warlock deck.
  audience:   msp, security-pro, agent
  capability: read, build, evaluate

@state
  status: active
  form_factor: ESP32 handheld (receive-only; never transmits)
  tagline: "A pocket Wi-Fi will-o'-the-wisp."
  how_it_works: "ESP32 promiscuous mode reads each frame's RSSI, filtered to the target's transmitter MAC (wlan.ta) — only that one radio drives the meter."
  features[6]{capability,detail}:
    lock-on,"Lock onto an access point — or a specific device — by its transmitter MAC; follows that one radio even when the SSID is hidden or spoofed"
    walk-it-down,"Buzzer ticks Geiger-style and speeds up as you get closer — homing by ear, eyes on the room"
    readout,"dBm, signal-bar, warmer-colder, and peak-hold readouts"
    radar,"A 'getting closer' radar animation that tightens as you approach"
    rogue-ap,"Built for walking a site and physically locating a rogue AP, a beaconing device, or an unknown client"
    sibling,"The Warlock deck's AP-locator shrunk to a wand — same idea (lock a transmitter MAC, follow its RSSI) in a one-hand tool"
  hardware[6]{component,detail}:
    handheld,"ESP32 — M5StickC Plus, M5 Cardputer, or LilyGo T-Display-S3 (built-in screen + battery)"
    radio,"ESP32 Wi-Fi in promiscuous (monitor) mode — RX only; Wisp never transmits"
    buzzer,"Piezo for the Geiger-style homing tone, faster as you close in"
    power,"Onboard LiPo — pocket-sized, all-day field tool"
    display,"Built-in LCD for dBm, bars, warmer-colder, peak-hold, and the radar animation"
    firmware,"Arduino / ESP-IDF; build-your-own from the documented source"

@actions
  - id: view_human
    method: GET
    href: /wisp.html
  - id: view_source
    method: GET
    href: https://github.com/techmages-org/wisp
  - id: the_deck
    method: GET
    href: /warlock.html

@context
  > Wisp is a battery-powered ESP32 handheld that physically locates a Wi-Fi radio. You lock it onto an access point — or a single client — by hardware (transmitter) MAC, and from then on it does one thing: tell you, by sound, whether you are getting warmer or colder. A buzzer ticks Geiger-style and speeds up as the signal climbs, backed by dBm / signal-bar / warmer-colder / peak-hold readouts and a radar "getting closer" animation. Internally it listens in ESP32 promiscuous mode and reads each frame's RSSI, filtered to the target's transmitter MAC, so a stronger AP nearby can't fool the needle. It is receive-only — no association, no handshake, nothing transmitted — built for finding rogue APs on site. Wisp is the handheld sibling to the Warlock deck: the deck's AP-locator, shrunk to a wand. Build-your-own from documented source on off-the-shelf ESP32 boards.

@nav
  self:      /wisp.agent
  parents:   [/.agent]
  peers:     [/warlock.agent, /deck.agent, /deck-gui.agent, /projects.agent, /index.agent, /charter.agent, /contribute.agent]