---
title: "pbl samples"
canonical_url: https://developer.repebble.com/pebbleos/docs/pbl/samples/
last_updated: 2026-11-13
sdk_version: 4.44
---
# pbl samples

Source: https://developer.repebble.com/pebbleos/docs/pbl/samples/

Build the samples under `samples/` for a board and, where the board runs on the host, run each one and check what it prints against its `sample.yml`. Samples are built only for the other boards.

```
pbl samples
pbl samples samples/kernel
pbl samples --board native_emery samples/kernel/work
pbl samples --list
```

Each sample is built in a directory of its own, `build-samples/<board>/<sample>/`, or under the directory given with `--build-dir`. The output of a build is only shown when it fails, and the console of a sample when a line it should print does not come; `--verbose` shows it for every sample.

[Samples](https://developer.repebble.com/pebbleos/docs/samples.md) lists the samples and covers writing one.

## Options

```
pbl samples [-h] [-b DIR] [--dry-run] [--lab FILE] [--watch NAME]
            [--wait [SECONDS]] [--board BOARD] [-l] [--build-only] [-v]
            [SAMPLE ...]
```

`SAMPLE`

Sample, or directory of samples, e.g. samples/kernel (default: all of samples/)

`--board BOARD`

Board to build for (default: qemu\_emery)

`-l, --list`

List the samples and exit

`--build-only`

Build the samples without running

`-v, --verbose`

Show the console of the samples that pass too

Generated from PebbleOS [f4926c952](https://github.com/coredevices/pebbleos/commit/f4926c952bf9b82bce9e3cdb44645a59531c0ee9). This page is maintained in the pebbleos repository: [docs/pbl/samples.md](https://github.com/coredevices/pebbleos/blob/f4926c952bf9b82bce9e3cdb44645a59531c0ee9/docs/pbl/samples.md).