README.md

Pebblexus

Pebblexus is a Pebble watchapp for checking Plexus quota status from your wrist.

Pebblexus groups quota meters from Plexus' management quota endpoint by provider/checker ID. Up/down move between groups, select refreshes the current list, and the footer shows the current page count. The phone-side PebbleKit JS stores the user's Plexus base URL and admin key; the key is never sent to the watch.

Requirements

  • mise
  • A Plexus instance reachable from the phone
  • A Plexus admin key for that instance

The development environment is described in mise.toml. It installs the pebble CLI through mise's pipx:pebble-tool backend, pins the Python runtime used by that tool, and adds the Pebble SDK toolchain to PATH.

Build

mise run build

mise run check runs the same build without requiring an emulator.

Test on Emery

mise run install
mise run screenshot

Interact with the app from the CLI:

mise run emu:up      # previous group
mise run emu:select  # refresh quotas
mise run emu:down    # next group
mise run emu:back    # long-press back

Optional app-icon generation uses the local Pebble skill helper and the Pebble tool Python environment, which includes Pillow via mise:

mise run icons