build: move non-build commands to own tool (pbl)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Joshua Jun <lets@throw.rocks>

Author: jplexer

.agents/skills/working-with-qemu/SKILL.md

@@ -10,8 +10,8 @@ PebbleOS can run under a custom QEMU version shipped with the PebbleOS SDK.
 ## Configure & build
 
 ```sh
-./waf configure --board $BOARD
-./waf build
+./pbl configure --board $BOARD
+./pbl build
 ```
 
 where `$BOARD` is any of the `qemu_*` boards:
@@ -25,7 +25,7 @@ QEMU boards target a specific platform, e.g. `qemu_emery` targets the Emery plat
 ## Launch
 
 ```sh
-./waf qemu
+./pbl qemu
 ```
 
 The launched QEMU exposes:
@@ -39,7 +39,7 @@ UART1 output is also captured to `build/uart1.log`.
 ## Console
 
 ```sh
-./waf console
+./pbl console
 ```
 
 Requires QEMU to be running.
@@ -48,8 +48,8 @@ Uses the TCP serial port to connect to the QEMU console, and provides a prompt f
 ## Screenshot
 
 ```sh
-./waf screenshot # defaults to build/screenshot.png
-./waf screenshot --screenshot-output /tmp/foo.png
+./pbl screenshot # defaults to build/screenshot.png
+./pbl screenshot --screenshot-output /tmp/foo.png
 ```
 
 Requires QEMU to be running.

AGENTS.md

@@ -35,15 +35,15 @@ PebbleOS is the operating system running on Pebble smartwatches.
 
 ## Firmware development
 
-- Configure: `./waf configure --board BOARD_NAME`
+- Configure: `./pbl configure --board BOARD_NAME`
 
-  - Board names can be obtained from `./waf --help`
+  - Board names can be obtained from `./pbl --help`
   - `-DCONFIG_RELEASE=y` enables release mode
   - `--mfg` enables manufacturing mode
   - `--variant=normal|prf` selects build variant (default: normal)
 
-- Build firmware: `./waf build`
-- Run tests: `./waf test`
+- Build firmware: `./pbl build`
+- Run tests: `./pbl test`
 
 ## Adding a new SDK function
 

docs/development/building_fw.md

@@ -13,7 +13,7 @@ Before attempting to flash, check the documentation for each {doc}`board <../boa
 You can flash the built firmware by running:
 
 ```shell
-./waf flash
+./pbl flash
 ```
 
 In some cases, you may have to specify the `--tty $SERIAL_ADAPTER` option where `$SERIAL_ADAPTER` is the path for your serial adapter, e.g. `/dev/ttyACM0`, `/dev/tty.usbmodem1102`, etc.
@@ -23,14 +23,14 @@ Some boards support direct resource programming by passing the `--resources` opt
 The alternative is to flash while the firmware is running via the serial port using:
 
 ```shell
-./waf image_resources --tty $SERIAL_ADAPTER
+./pbl image_resources --tty $SERIAL_ADAPTER
 ```
 
 When both firmware and resources are flashed, you should observe the watch booting into the main application.
 You can also see the logs by opening the console:
 
 ```shell
-./waf console --tty $SERIAL_ADAPTER
+./pbl console --tty $SERIAL_ADAPTER
 ```
 
 Try sending `help` to get a list of available console commands.

docs/development/options.md

@@ -1,6 +1,6 @@
 # Configuration Options
 
-When configuring the build (`./waf configure ...`) there are several options you can enable or tune.
+When configuring the build (`./pbl configure ...`) there are several options you can enable or tune.
 Below you will find a list of the most relevant ones.
 
 ## Choosing your target

docs/development/qemu.md

@@ -14,8 +14,8 @@ The QEMU binary ships with the [PebbleOS SDK](https://github.com/coredevices/Peb
 The steps here are similar that of real hardware:
 
 ```shell
-./waf configure --board=$BOARD
-./waf build
+./pbl configure --board=$BOARD
+./pbl build
 ```
 
 where `$BOARD` is one of the dedicated QEMU boards (`qemu_emery`,
@@ -26,27 +26,27 @@ where `$BOARD` is one of the dedicated QEMU boards (`qemu_emery`,
 You can launch QEMU with the built image using:
 
 ```shell
-./waf qemu
+./pbl qemu
 ```
 
 The flash image is rebuilt by default on every launch. To keep the existing flash image (e.g. to preserve stored apps), pass `--keep-flash-image`:
 
 ```shell
-./waf qemu --keep-flash-image
+./pbl qemu --keep-flash-image
 ```
 
 ## Console
 
 You can launch a console using:
 
 ```shell
-./waf console
+./pbl console
 ```
 
 ## Debug
 
 You can debug with GDB using:
 
 ```shell
-./waf debug
+./pbl debug
 ```