Command-line Interface (CLI)
Overview
The Nimbus Command Line CLI allows you to control and inspect your robot agent directly from a terminal without using the web UI. It mirrors most operations available on the Cogniteam Cloud Platform and exposes additional diagnostic and maintenance tools.
To see the built-in help menu:
nimbus -h
Each top-level manager exposes its own set of subcommands:
nimbus <group> <command> [arguments]
Connection And Access
CLI manager commands communicate with the running Agent over gRPC. A connection through the
Agent's actual loopback address can run without a password. When targeting an Agent on another
computer with authentication enabled, set the existing NIMBUS_CLI_AUTH environment variable to
that Agent's password. Supply the password itself; the CLI encodes its authentication header for
both ordinary commands and streaming commands. Explicit NoAuthentication configuration permits
password-free management access.
Shell completion uses the Agent's localhost HTTP endpoint and is restricted to the Agent computer. A remote password or bearer token does not enable remote completion. Completion remains noninteractive and does not open a browser login.
Command Groups
| Command | Description |
|---|---|
| session | Manage active I/O sessions |
| platform | Inspect hardware, OS, and device info |
| kpi | Monitor real-time KPI updates |
| notification | List notification settings and watch emitted notifications |
| debug | Manage Debug settings and support bundles |
| config | Load, stop, or inspect configurations |
| system | Manage agent versions, logs, and services |
| comp | Manage components (start/stop/stats/params) |
| device | List registered hardware devices |
| stream | View and manipulate data streams |
| rtsp-streaming | Manage saved on-demand RTSP video profiles |
| service | Call or inspect ROS services |
| security | Security hardening and access control |
| task | Manage persisted agent tasks and task catalog files |
| fleet | Manage local fleet robots and fleet presets |
| preset | Manage robot presets |
| record | Record and upload sensor data (previously datalog) |
| file | Inspect file status, upload files, and synchronize storage |
| param | Manage ROS1/ROS2 dynamic parameters |
| ros2-listen / grep | Discover ROS 2 topics and search CLI commands |
| nav2 | Run Nav2 commands |
| actions | Discover, execute and observe registered ROS2 actions |