Skip to content

tlm-cli pms events

Commands for browsing and creating device events recorded in the Product Management System (PMS).

tlm-cli pms events [COMMAND] [OPTIONS]

Events are split into two kinds:

  • public — events visible externally (e.g. shipping, delivery, activation)
  • internal — events visible only to operators (e.g. test results, quality checks)

list

List events sorted by date (most recent first) with interactive pagination.

tlm-cli pms events list KIND [OPTIONS]

Fetches events in batches of 200 and displays 25 at a time.

Argument Values Description
KIND public | internal The event kind to query.
Option Type Description
--type TEXT string Filter by event type (fuzzy match).
--serial TEXT string Filter by device serial number (fuzzy match).

Keyboard shortcuts

Key Action
Enter Next page
d Toggle detail view (adds Description, Operator ID, Body JSON)
q or Esc Quit

Examples

# List most recent public events
tlm-cli pms events list public

# List internal events for a specific device
tlm-cli pms events list internal --serial "SN-001234"

# Filter public events by type
tlm-cli pms events list public --type "shipped"

# Combine filters
tlm-cli pms events list internal --type "test" --serial "SN-001234"

Compact view columns: Event Type, Date, Device, Customer

Detail view adds: Description, Operator ID, Body (JSON)

create

Create a new public or internal event for a device interactively.

tlm-cli pms events create KIND --serial TEXT --customer TEXT

Opens an interactive editor to fill in event attributes. Both the device and customer must already exist in the system.

Argument / Option Type Required Description
KIND public | internal yes The event kind to create.
--serial TEXT string yes Serial number of the target device (exact match).
--customer TEXT string yes Customer code to assign to the event (exact match).

Example

tlm-cli pms events create public --serial SN-001234 --customer ACME
tlm-cli pms events create internal --serial SN-001234 --customer ACME