Skip to content

CLI Command Reference

Full reference for all tlm-cli commands grouped by sub-application.

Command tree

tlm
├── admin
│   ├── customers     list · show · create · update · delete
│   ├── users         move · remove
│   ├── iam
│   │   ├── roles     show · add-action · remove-action
│   │   └── policies  show · add-resource · remove-resource
│   └── trials        create · delete
├── cs
│   ├── projects      list · show · create · clone · move
│   ├── bom           upload
│   ├── metrics       cves
│   └── vex           upload
├── fm
│   └── devices       list · show · claim · unclaim · claim-bulk
└── pms
    ├── devices        list · show · subdevices · set-model · set-model-batch
    ├── events         list · create
    ├── firmwares      show · create · delete
    ├── models         list · show · create · delete
    ├── parts          list · show · create · update · set-internal-info · set-model · family · subparts (list · add · remove)
    └── provisioning   provision · unprovision · get-certificate

Sub-application reference

Sub-application Description
admin Customer, user, IAM, and trial tenant management
cs Cybersecurity — manage projects, upload BOMs, track vulnerability metrics, submit VEX documents
fm devices Fleet device management — list, inspect, claim, unclaim, and bulk-claim devices
pms devices Manufacturing device management — list, inspect, assign models
pms events Manufacturing event log — browse and create public and internal events
pms firmwares IoT firmware management — create, inspect, and delete firmware
pms models IoT model management — list, create, inspect, and delete models
pms parts Part management — list, create, update, inspect, set internal info, assign models
pms provisioning Device provisioning — provision, unprovision, get certificates

Common patterns

Pagination

Commands that list resources (list, events list) use interactive pagination. Fetch 200 records at a time from the API and display 25 per screen. Use Enter to advance, d to toggle detail view, and q or Esc to quit.

Dry run

Mutating commands (create, update, provision, claim-bulk, set-model-batch, etc.) support --dry-run. This prints what the command would do without making any changes — useful for previewing bulk operations.

Confirmation prompts

Destructive or bulk operations show a confirmation prompt before proceeding. Pass --yes / -y to skip the prompt in scripts.