CLI

Overview

The menlo CLI lets you manage your robots, configure API access, join live sessions, and send basic motion commands directly from the terminal.

Installation

Install the CLI with a single command or build from source.

Init

Set up your API key and select a default robot interactively.

Robot

List robots, check status, join sessions, send actions, and set your default robot.

Config

Manage your API key and default robot configuration.

Installation

Quick Install

sh -c "$(curl -fsSL https://raw.githubusercontent.com/menloresearch/cli/release/install.sh)"

Build from Source

git clone https://github.com/menloresearch/cli
cd cli
go build -o menlo ./cmd/menlo

Uninstall

sh -c "$(curl -fsSL https://raw.githubusercontent.com/menloresearch/cli/release/uninstall.sh)"

menlo init

Initialize the CLI with your API key and select a default robot.

menlo init

This is the fastest way to get started. It prompts for your API key and lets you pick a default robot from your account.

If you have not created a robot yet, you can skip selection and set it later with menlo robot connect.

Manage your robots. You can create virtual robots at https://platform.menlo.ai. Physical Asimov robots are controlled directly via the Asimov API; registering them through the Menlo CLI is coming soon.

List Robots

menlo robot list

Show Robot Status

menlo robot status                          # Use default robot
menlo robot status --robot-id <robot-id>   # Use specific robot

Status includes robot metadata such as name, id, model, and type.

Join a Session

Connect to a robot's live WebRTC session.

menlo robot session                          # Use default robot
menlo robot session --robot-id <robot-id>   # Use specific robot

Once connected, follow the Asimov API documentation to control the robot, receive telemetry, or stream video over the LiveKit WebRTC session.

The session command returns values like:

Connection Endpoint:
xxx

Agent Token:
xxx

Debug View:
xxx

You can use these values to connect programmatically with the Asimov API.

Send Commands

You can test basic control directly from the CLI:

menlo robot action <command>

Valid commands: forward, backward, left, right, turn-left, turn-right, stop.

Set Default Robot

menlo robot connect              # Interactive selection
menlo robot connect <robot-id>   # Set directly

This is equivalent to running menlo config default-robot.

menlo config

Manage CLI configuration.

API Key

menlo config apikey <your-api-key>   # Set API key
menlo config apikey                  # Show current API key

You can get your API key from https://platform.menlo.ai/account/api-keys.

Default Robot

menlo config default-robot <robot-id>   # Set directly
menlo config default-robot              # Interactive selection

Configuration File

Configuration is stored locally at:

Platform	Path
macOS	`~/Library/Application Support/menlo/config.yaml`
Linux	`~/.config/menlo/config.yaml`
Windows	`%APPDATA%\menlo\config.yaml`

CLI

Installation

Init

Robot

Config

On this page