Skip to content

ToloMEO CLI

tlm-cli is the command-line interface for the ToloMEO Manager platform. It provides access to all platform modules — administration, manufacturing, and fleet management — directly from the terminal.

Capabilities

Sub-command Area Description
tlm-cli admin Administration Manage customers, users, and permissions
tlm-cli pms Manufacturing Devices, parts, events, models, and device provisioning
tlm-cli fm Fleet Monitor and manage deployed devices

Installation

With uv (recommended):

git clone git@gitlab.com:DAVEEmbeddedSystems/public/tolomeo-public-projects/tools/tlm-cli.git
cd tlm-cli
uv sync
uv pip install -e .

With pip:

pip install tlm-cli \
  --extra-index-url https://gitlab.com/api/v4/projects/81184835/packages/pypi/simple

Configuration

Create ~/.config/tlm-cli/.config.toml with your instance credentials:

[application]
instance = "your-instance.example.com"

[auth]
username = "you@example.com"
password = "your-password"

Restrict permissions to protect credentials:

chmod 600 ~/.config/tlm-cli/.config.toml

The CLI searches for the config file in order: current directory, ~/.config/tlm-cli/, /etc/tlm-cli/.

Quick start

# Explore available commands
tlm-cli --help
tlm-cli pms --help
tlm-cli fm --help

# List manufacturing devices
tlm-cli pms devices list

# List fleet devices
tlm-cli fm devices list

List commands use an interactive paginated display. Press Enter to advance, D to toggle detail view, Q to quit.

PMS vs Fleet Manager

The CLI distinguishes between two device registries:

PMS (tlm-cli pms) Fleet Manager (tlm-cli fm)
Purpose Manufacturing record Operational fleet registry
Tracks Parts, serial numbers, production data, events, provisioning Claimed devices, live status
Lifecycle stage Design through provisioning Post-deployment and monitoring

See the PMS Setup flow to define parts and customers before manufacturing, and the Device Provisioning flow for the end-to-end manufacturing and registration walkthrough.